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The System Productivity Facility (SPF) is a program development 
tool designed to take advantage of the characteristics of IBM 3270 
display terminals, and to increase programmer productivity in an 
interactive environment. 


The System Productivity Facility replaces the previous Structured 
Programming Facility program products (SPF/TSO and SPF/CMS). It 
includes significant new functions that simplify the development 
of interactive applications. 


New services are provided to define and control symbolic vari- 
ables, display predefined screen images and messages, build and 
maintain permanent tables of user information, generate output 
files for job submission or other processing, interface to edit 
and browse, and log hardcopy output. 


This manual provides an overview and functional description of 
SPF under the MVS Time Sharing Option. It is intended to provide 
planning information for installation and use of the product. 


A separate manual, GC34-2046, provides general information about 
SPF under the VM/370 Conversational Monitor System. 


This manual is divided into the following chapters: 


1. Introduction ~ A general overview of SPF, including its 
structure and function. 


2. Dialog Manager ~- A description of the control facilities and 
rel ae that support the operation of interactive applica- 
ions. 


3. Program Development Facility - A description of the interac” 
tive facilities that support program development, including 
browse, edit, utilities, foreground and background process-— 
ing, end online tutorial. 


4. Planning - A description of system requirements, customer 
responsibilities, and related documentation. 


5. Program Summary - A summary of licensing and testing pro- 
visions, and planned availability. 


The manual also includes an appendix describing the differences 
in SPF facilities in the MVS and VM environments. 
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HAPTER TRODUCTION 


The System Productivity Facility (SPF) is a new program product 
which replaces both of the previous Structured Programming Facil- 
ity products (SPF/TSO and SPF/CMS). The new product supports two 
environments: 


e MVS Time Sharing Option (SPF-MVS) 
e VM/370 Conversational Monitor System (SPF-VM) 


The new name, System Productivity Facility, reflects the addition 
of significant new functions beyond the support for structured 
programming. The new functions simplify the development of inter- 
active rg aa that run under control of SPF and use new SPF 
services to: 


Define and control symbolic variables 

Display predefined screen images and messages 

Build and maintain permanent tables of user information 
Generate output files for job submission or other processing 
Interface to edit and browse, and log hardcopy output 
Control operational modes. 


Conceptually, SPF consists of two major components: the dialog 
manager and the program development facility (see Figure 1). The 
dialog manager provides control and services for running interac— 
tive applications. One such application is the program develop- 
ment facility, which includes the previous SPF functions. 


The dialog manager allows totally new applications to be devel- 
oped, each with its own primary option menu. Applications may be 
independent, entered via separate command procedures, or linked 
via menu options which transfer from one application to another. 


DIALOG MANAGER 


CONTROL FACILITIES 
Menu/Tutorial Traversal 
Screen Management 
Program Key Interpretation 


SERVICES 
Variable Definition/Control 
Display 
Table Creation/Maintenance 
File Tailoring 
Other 


OGRAM DEVELOPMENT FACILITY 
SPF Parms 


Utilities 
Foreground 
Background 
Command 
Support 
Tutorial 


Figure 1. SPF Organization 
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The dialog manager includes a new panel! display service with 
enhanced function and improved usability over the previous SPF 
display capability. 


Installations which have previously extended or custom tailored 

SPF may need to convert old format selaction manus, tutorials, and 

messages to the new panel and message formats. Conversion utili- 

ties have been provided for this purposa in the program develop- 

ment facility (new option 7 on the primary option menu). 

Advantages of the new panel and message formats include: 

© Communication of user inputs (from panels) and substitution 
of parameters Cin messages) via symbolic variables rather 
than positional calling sequence parameters. 

° Ability to verify user inputs in panel definitions. 

e Ability to test and set variables in panel definitions. 


e Improved control over panel field attributes, including spec~” 
ification of padding characters and justification. 


e Replacement of LIST/RETURN keywords with TRANS keyword, in 
which the source and translated values are paired. 


e Simplification of selection manu and tutorial panel formats. 


The program development facility provides interactive facilities 
for program development and maintenance, including: 


e SPF Parms - To specify terminal characteristics, including 
program function (PF) keys, and other SPF parameters. 


e Browse — To display source data or output listings. 


e Edit - To create or change source data, including program 
code, test data, or documentation. 


° Utilities - To perform a variety of library and data set spec— 
ification and maintenance functions. 


e Foreground - To execute language processors (compilers, 
assembler, and linkage editor) in the foreground. 

e Background ~- To execute language processors in the back~- 
ground. 


e Command - To execute a T50 command or CLIST under SPF. 


e Support - To test a panel or dialog function, or convert old 
format menus/messages to new format. 


° Tutorial - To provide online instruction and reference in the 
operation of the program development facility. 


Typically, the end user of the program development facility is an 
application or systems programmer. The program development 
facility may also be useful for administrative and clerical per- 
eonue: who have some knowledge of the operating system environ- 
ment. 


Previously, all SPF screen images were called menus. The terminology 
has been changed to more closely reflect general usage. The term menu 
is now used to mean a display from which the user may salect options. 
The term panel is used to mean any predefined display image, of which 
one type is a menu. 
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A “dialog” is any application designed to be run under the SPF 
dialog manager. Each dialog is composed of various program and 
data elements, which allow an orderly interaction between the 
computer and the end user of the application. The types of ele- 
ments that make up a dialog are: 


® Panels. A panel is a predefined display image. It may be a 
selection menu, a data entry display, or an information dis- 
play Ce.g., help/tutorial panel). Most panels prompt the 
user for information. The user response may identify which 
path is to be taken through the dialog, or it may be inter- 
preted as data. 


e Messages. A message is a comment that provides special infor- 
mation to the user. It may alert the user about what to 
expect next, confirm that a user-requested action is in 
progress or completed, or report an error in the user's input. 
Messages may be directed to the user's terminal, to a hardcopy 
log,» or both. 


° Functions. A function is a program that controls the sequence 
in which panels and messages are displayed, oversees the han- 
dling of data and files, and performs processing functions 
requested by the user. A function may be a compiled Cand link 
edited) program or a CLIST. 


e Tables. A table is a two-dimensional array used to maintain 
data. A table may be created as a temporary data repository, 
or it may be retained across sessions. A retained table may 
also be shared between different applications. The type and 
amount of data stored in a table depends upon the nature of 
the application. 


e File Skeletons. A file skeleton is a generalized representa- 
tion of sequential data which may be customized during dialog 
execution to produce an output file. The customization con- 
sists of the selection of lines to be included in the output, 
and the substitution of variables originating from functions, 
panels, or tables. The output file may be used to drive other 
processes. File skeletons are frequently used to produce job 
files for batch execution. 


A dialog need not include all types of elements. In particular, 
tables and file skeletons may not be needed, depending upon the 
type of application. 


Panels, messages, and file skeletons are constructed by the dia- 
log developer and stored in libraries (partitioned data sets) 
prior to execution of the dialog. They are created by editing 
directly into the panel, message, or skeleton libraries; no com- 
pile or preprocessing step is required. 


Functions are coded (Cand, for program modules, compiled and link 
edited) by the dialog developer and stored in load module or com- 
mand libraries. They are invoked ‘from menus or from other func— 
tions during dialog execution. 


Tables are generated or updated dynamically during dialog exe- 
cution. The organization of each table is preplanned by the dialog 
developer, and specified to SPF by the functions that use SPF 
table services. 
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The SPF dialog manager provides control facilities ta: 


e Traverse a hierarchy of selection menus and invoke the appro- 
priate dialog functions. 


° Transfer in and out of the tutorial, and control the sequence 
of tutorial pages based on user inputs. 


° Manage the physical display image in single screen or split 
screen mode. 


e Interpret program function (PF) key usage for system defined 
functions. 


The overall flow of control is shown in Figure 2. The dialog man- 
ager is invoked via the ISPF command. (An SPF command may be 
established as an alias of ISPF). The command may be entered by a 
user at the terminal or invoked from a CLIST. Command parameters 
may be used to specify: 


e The first selection menu to be displayed, or 


e The first dialog function to receive control (prior to the 
display of a menu). 


If a dialog function is specified, it may perform 
application-dependent initialization, and then invoke the SELECT 
service to display the first menu. If neither a selection menu 
nor a dialog function is specified, the SPF program development 
facility is invoked. 


Before the dialog can begin, the SPF envirot.ment must be initial- 
ized. This is done by the controller. The controller then calls 
the SELECT service to display the first menu or invoke the first 
dialog function, as specified via the ISPF command. 


MENU TRAVERSAL 
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Selection menus are normally organized in a hierarchical struc” 
ture. Each menu contains sufficient information to determine the 
next action to be taken for any option entered by the user. The 
naxt action may be: 


e Display a lower level selection manu, or 
Invoke a dialog function. 


Selection menus are displayed by the SELECT service. The SELECT 
service Will display the first menu and continue to display suc- 
cessively lower levels of menus, until a dialog function is speci- 
i the next action. The SELECT service will then invoke the 
unction. 


A dialog function may display additional panels (via the DISPLAY 
service), and invoke other SPF services to continue the dialog. 
When the function completes execution, it returns to the SELECT 
service. The selection menu from which tha function was invoked 
is then redi splayed. 


SPF-MVS General Information Manual 


ISPF 


Vv 
CONTROLLER 


VARIABLE 
SERVICES 


Vv 


SELECT 
SERVICE ( PANEL 
\ LIBRARY 
DISPLAY 
SERVICE 
s / MESSAGE 
Vv E \ LIBRARY 
R 
DIALOG V 
FUNCTION I 
c 
E TABLE / \ DATA 
S SERVICES \ / TABLES 
/ SKELETON 
FILE \ LIBRARY 
TAILORING 
SERVICES 
> CONTROL FLOW 
\ 
7 DATA FLOW 


Figure 2. Flow of Control 
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The foregoing describes a dialog organization in which selection 
menus are displayed first, and dialog functions are invoked from 
the menu options. The functions are the "end points” of each leg 
of the menu hierarchy. Other types of dialog sequences may be 
constructed by means of the following features: 


° Any dialog function may use the SELECT service to display 
additional selection menus. A function, for example, might 
display data entry panels to gather user information and then 
cause a selection menu to be displayed from which lower level 
functions may be invoked. 


® Any dialog function may use the SELECT service to pass control 
directly to another dialog function without displaying a 
menu. This provides a simple way to pass control from a pro- 
gram module to a CLIST, or vice-versa. 


e Parameters may be passed to any dialog function from the 
selection menu or function which invokes it. These parame- 
ters may be used, for example, to pass the name of a panel to 
be displayed, a table to be updated, or a file skelaton to be 
used by the function. 


e Whenever a selection menu is specified from the SPF command or 
via a parameter passed to the SELECT service, an initial 
option may also be specified. This causes the menu to be 
processed as if the user had entered the specified option, 
without actually displaying the menu. 


ONLINE TUTORIAL 
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A tutorial is a set of panels that provide online information to 
the end user. As with other panels, the tutorial is constructed 
by the dialog developer and stored in the panel library prior to 
execution of the dialog. 


The program that displays tutorial pages is part of the dialog 
manager. It may be entered in either of two ways: 


° As a selectable option from a menu, or 


° Indirectly from any non-tutorial panel when the user presses 
the Help PF key. 


Transfer in and out of the tutorial via the Help key is transpar- 
ent to the dialog functions. 


Tutorial panels are arranged ina hierarchy. When the tutorial is 
entered from a menu, the first panel to be displayed is normally 
the top of the hierarchy. When the tutorial is entered via the 
Help PF key, the first panel to be displayed is some appropriate 
panel within the hierarchy, depending upon what the user was doing 
when the Help key was pressed. 


When viewing the tutorial, the user may select topics by number 
Cor other appropriate selection code), or simply press the ENTER 
key to view the next topic. On any panel, the user may also enter 
the following commands: 


BACK or B- to back up to the previously viewed panel 
SKIP or S - to skip to the next topic 

UP or U ~ to display a higher level list of topics 
TOP or T ~ to display the table of contents 

INDEX or I - to display the tutorial index. 


When the user has finished viewing the tutorial, the panel from 
which the tutorial was entered is redisplayed. 
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SCREEN MANAGEMENT 


PROGRAM 


At any time during a dialog, the end user may partition the dis- 
play screen into two "logical”™ screens. The two logical screens 
are treated as though they were independent terminals. The dialog 
manager provides control for mapping the two logical screens onto 
the physical screen. 


In split screen mode, one or the other of the logical screens is 
considered active at any point in time. The location of the cur- 
sor is used to identify which of the two screens is active. 


Split screen mode is antered by means of the Split PF key, which 
may also be used to reposition the split line. Split screen mode 
is terminated by ending the application on either logical screen. 
The remaining logical screen is then expanded to its full size. 


Use of split screen mode and positioning of the split line is 
under control of the end user, and totally transparent to the dia- 
log function. Panels that are displayed by the DISPLAY service 
always pertain to a logical screen. 


ACCESS AND FUNCTION KEYS 


The dialog manager supports display terminals that have two 
program access (PA) keys, and 12 or 24 program function (PF) keys. 
Some keys have system-defined meanings; these are handled by the 
dialog manager, and are transparent to the dialog function except 
for the End key. 


Other keys may be equated to application-defined commands; these 
are passed through to the dialog function, as if the user had 
typed the command on the screen and pressed the ENTER key. 


The two PA keys have system-defined meanings. They may not be 
redefined by the user. 


ATTENTION (CPA1) This key is logically disabled whenever the 
keyboard is unlocked, except during execution 
of a TSO command. 


RESHOW (PA2) Redisplays the contents of the screen. 


The system-defined PF key operations are described below. The 
default key assignments are shown in parentheses. For 24-key ter- 
minals, PF keys 1-12 have the same defaults as keys 13-24. 


HELP CPF1/13) Displays additional information about a message 
or causes a transition into the tutorial. 


SPLIT CPF2/14) Causes split screen mode to be entered, or 
changes the location of the split line. 


END (PF3/15) Terminates the current operation and returns to 
the previous menu. If the primary option menu 
He displayed, this key terminates the applica- 

ion. 


RETURN (C(PF4/16) Causes an immediate return to the primary 
option menu. (CLogically equivalent to repeated 
use of the End key.) May also be used to jump 
directly from one function to another, without 
displaying the primary option menu. 


UP CPF7/19) Causes a scroll up. 
DOWN (PF8/20) Causes a scroll down. 
SWAP CPF9/21) Moves the cursor to wherever it was previously 


positioned on the other logical screen. 
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LEFT CPF10/22) Causes a scroll laft. 
RIGHT (PF11723) Causes a scroll right. 


CURSOR (PF12/24) Moves the cursor to the first input field on 
line 2 (normally, the option selection or com- 
mand input field). Pressing this PF key again 
causes tha cursor to be moved to the second 
input field on line 2, if any (normally the 
scroll field). 


PRINT (none) Causes a "snapshot" of the screen image to be 
recorded in the SPF list file. 


PRINT“HI (Cnone) Same as PRINT except that high intensity 
characters on the screen are printed with over~ 
strikes to simulate the dual intensity display. 


NOP (none) Causes the PF key to be functionless. 


The scroll keys are used if the dialog function invokes the table 
display service (TBDISPL) or the interfaces to edit and browse. 
During execution of the tutorial, the four scroll PF keys are 
interpreted as follows: 


UP - same as UP command 

DOWN = same as SKIP command 

LEFT —- same as BACK command 

RIGHT - same as ENTER key (display next page). 


The PRINT, PRINT-HI, and NOP functions have no default PF key 
assignments. 


The end user may rearrange the system-defined keys, and may rede~ 
fine system keys to application-defined commands. The only sys- 
tem key function which is required is the End key. 


DIALOG SERVICES 


The SPF dialog manager provides a comprehensive set of services 
that allow an application to: 


Define and control symbolic variables 

Display predefined screen images and messages 

Build and maintain permanent tables of user information 
Generate output files for job submission or other processing 
Interface to edit and browse, and log hardcopy output 
Control operational modes. 


SPF services may be invoked from a CLIST by means of the ISPEXEC 
command. Example: 


ISPEXEC DISPLAY PANELC(XYZ) 


ines command invokes the DISPLAY service to display a panel named 


SPF services may be invoked from programs by calling a service 
interface routine, named ISPLINK. Example: 


CALL ISPLINK C'DISPLAY', XYZ); 


ISPLINK is a small object module which is distributed with SPF. It 
should be link edited with the program functions that call it. It 
may be called from programs coded in any language that uses stand- 
ard OS register conventions for call interfaces. 
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' Variable services allow data elements to be identified and used as 
"dialog variables." A dialog variable is a character string that 
may vary in length from zero to 32K bytes. It is referenced sym- 
bolically, by name. The name may be from one to eight alphameric 
eoeeoeens in length, and must begin with an alphabetic charac- 

er. 


Dialog variables serve as the main communication vehicle between 
dialog functions and SPF services. They may also be used to com- 
municate between a function and another function. 


Dialog variables are either referenced implicitly or defined to 
SPF, depending upon the type of dialog function. 


For CLIST functions, the variables are always referenced implic— 
itly. All CLIST variables are automatically treated as dialog 
variables; no special action is required to define them to SPF. 
CLIST variables are created dynamically either by execution of 
the CLIST or by the SPF services that the CLIST uses. Example: 


SET AAA = 1 
ISPEXEC DISPLAY PANELCXYZ) 
SET CCC = &BBB + &AAA 


Variable AAA is created by the CLIST, simply by setting it to a 

value. The CLIST then invokes the DISPLAY service to display panel 

XYZ. If panel XYZ references variable AAA, its value may be dis- 

Cc ery tooo ad changed by the user, depending on how the panel is 
efined. 


The same panel may allow the user to enter a value for another 
variable (BBB). If the CLIST has not already created a variable 
BBB, the variable will be created automatically. Its value may 
then be referenced in a subsequent CLIST statement. 


For program functions (compiled modules), dialog variables that 
are to be referenced by the function must be explicitly defined to 
SPF. The function calls the VDEFINE service to identify the name, 
address, format, and length of one or more variables within the 
program to be used as dialog variables. Example: 


DECLARE AAA CHAR(8); 
CALL ISPLINK (C'VDEFINE', "CAAA)', AAA, "CHAR", 8); 
CALL ISPLINK C'DISPLAY', XYZ); 


Variable AAA is declared as an internal program variable (charac— 
ter string, length 8). The program calls the VDEFINE service to 
define it as a dialog variable. The program then calls the DIS~- 
PLAY service to display panel XYZ. If panel XYZ references vari- 
able AAA, its value may be displayed or changed by the user, 
depending on how the panel is defined. 


If panel XYZ allows the user to enter a value for another variable 
(BBB) and the program has not defined a dialog variable of that 
, name, storage for the variable will be allocated automatically. 
BBB is then considered an implicit dialog variable associated 
with this function. The program has no means of accessing BBB, 
since it has not been explicitly dafined. But if the program 
invokes another SPF service, the service will be able to access 
eee modify the variable (see "Scope of Variables" which fol- 
ows). 


C The VDELETE service performs the opposite function of VDEFINE. It 


may be called to specify the names of one or more program vari- 
ables which are no longer to be treated as dialog variables. 
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Scope of Variables 


The scope of a dialog variable may be limited to an individual 
function or shared between functions. 


When a variable is created, it is associated with the function 
that is currently in control and may not be referenced by other 
functions. When the function completes execution, all of its dia- 
log variables (defined and implicit) are automatically deleted. 


When a function invokes a lower level function via the SELECT 
service, the lower level function has its own seat of variables 
(which may have the sama names as variables belonging to other 
functions). Again, the lower level function may not access the 
variables of the invoking function. 


A shared variable pool is available to allow communication of var- 
iables between functions. A function may copy one or more of its 
variables into the shared variable pool by means of the VPUT serv- 
ice. Another function may then obtain a copy of the variables by 
means of the VGET service. 


Figure 3 shows the logical relationships between different sets 
of variables. An application with three functions is shown. Funcu- 
tion X has both defined and implicit variables. Function Y has 
onty defined variables, and function Z has only implicit vari-~ 
a es. 


When variables are accessed by SPF services, the search starts 
with the dialog variables for the current function -- first the 
defined variables Cif any), than the implicit variables Cif any). 
If a variable is not found, the search continues with the shared 
variable pool. If the variable is still not found, its current 
value is assumed to be null. 


When a variable is created or updated by an SPF service, it is 
stored in the current function's defined area if a variable of 
that name has been explicitly defined. Otherwise, it is stored in 
the current function's implicit area. 


Function X Function Y Function Z 


Detined 
Eo _ 


Shared Variable Pool 


Figure 3. Sets of Variables 


10 SPF-MVS General Information Manual 


C 


stem Variabl 


Certain variable names are reserved for use by the system. They 
all begin with the letter "Z". Dialog developers should avoid 
names which begin with "Z" when choosing dialog variable names. 


Some system variables cannot be modified. They provide the dialog 
with information about the environment, such as user id, current 
date and time, and terminal characteristics. These variables 
reside in the shared variable pool, and may be obtained via the 
VGET service. 


Other system variables are used for communication between the 
dialog and certain control facilities within the dialog manager. 
These variables provide information about error conditions and 
allow designation of key tutorial pages. 


DISPLAY SERVICE 


The DISPLAY service reads a panel definition from the panel 
library, initializes variable panel fields from the corresponding 
dialog variables, and displays the parel on the screen. A message 
may optionally be displayed with the panel. After the user 
presses ENTER or a PF key, user inputs are stored into correspond- 
ing dialog variables, and the display service returns to the call- 
ing function. 


A separate service is provided to display tabular information in 
scrollable format. See "Table Display Service." 


Pane fini 


q 5 


A panel definition consists of up to four sections, of which only 
the body is required: 


1. 


Attribute section (Coptional) - defines the special characters 
that will be used in the body of the panel definition to 
represent attribute (start of field) bytes. Default attri- 
bute characters are provided, which may be overridden. 


Body Crequired) ~ defines the format of the panel as seen by 
the ore and defines the name of each variable field on the 
panel. 


Initialization section Coptional) - specifies the initial 
processing that is to occur prior to displaying the panel. 
Typically used to define how variables are to be initialized. 


Processing section Coptional) ~- specifies processing that is 


to occur after the panel has been displayed. Typically used 
to define how variables are to be verified and/or translated. 
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Panel Fields 


The special characters defined in the attribute section (or the 
default attribute characters) are used in the panel body to indi- 
i A as of each field, which is also the end of the preced- 
ing field. 


The default attribute characters are: 


% (percent sign) - text (protected) field, high intensity 
+ Cplus sign) ~ text (protected) field, low intensity 
_ Cunderscore) - input Cunprotected) field, high intensity 


For text fields, the information following the attribute characy 
ter is the text to be displayed. Text fields may contain substi-~ 
tutable variables, consisting of a dialog variable name preceded 
by an ampersand (&). The name and ampersand are replaced with the 
value of the variable prior to displaying the panel. 


For input fields, a dialog variable name immediately follows the 
attribute character (with no intervening ampersand). The name is 
replaced with the value of the variable prior to displaying the 
panel, and any information entered by the user is stored in the 
variable after the panel has been displayed. 


Inclusion of an attribute section, which precedes the panal body, 
allows the default attribute characters to be changed and/or 
additional attribute characters to be defined. 


In defining new attribute characters, the following character- 
istics of the field may be speci fied: 


Type - text, input, or output 

Intensity - high, low, or non~-display 

Caps - automatic translation to uppercase (on or off) 
Justification - left, right, or as-is 

Pad - nulls, or any character Cincluding blank) 


Panel Definition Examples 
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A sample panel definition is shown in Figure 4. It consists ofa 
panel body followed by an ")JEND" control statement. It has no 
attribute, initialization, or processing sections. It uses the 
default attribute characters. 


This is a data entry panel with ten input fields (TYPECHG, LNAME, 
etc.), indicated with underscores. It also has a substitutable 
variable CEMPSER) within a text field Con line 2). The first two 
lines of the panel and the arrows preceding the input fields are 
all highlighted, indicated with percent signs. The other text 
fields are low intensity, indicated with plus signs. 


Before the panel is displayed, all variables in the panel body 
will be automatically initialized from the corresponding dialog 
variables (CTYPECHG, LNAME, etc., and EMPSER). After the panel has 
been displayed, the input fields will be automatically stored 
into the corresponding dialog variables. 


Figure 5 shows the panel as it will appear when displayed, assum- 
ing that the current value of EMPSER is "123456", and that the 
other variables are initially null. 
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ZEMPLOYEE SERIAL: &EMPSER 


TYPE OF CHANGEZ===>_TYPECHG + (NEW, UPDATE, OR DELETE) 


EMPLOYEE NAME: 
LAST %===>_LNAME 
FIRST %===>_FNAME 
INITIAL%===>_1+ 


HOME ADDRESS: 
LINE 1 
LINE 2 2 
LINE 3 
LINE 4 


HOME PHONE: 
AREA CODE 
>_PHNUM + 


Figure 4. Sample Panel Definition 


EMPLOYEE SERIAL: 123456 
TYPE OF CHANGE ===> (NEW, UPDATE, OR DELETE) 


EMPLOYEE NAM 
LAST 
FIRST 
INITIAL 


> 
> 
> 


HOME ADDRE 
LINE 1 
LINE 2 
LINE 3 
LINE 4 


ss 


> 
> 
> 
> 


HOME PHONE: 
AREA CODE 
LOCAL NUMBER 


Figure 5. Sample Panel - When Displayed 
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Figure 6 shows a sample panel definition with an initialization 
section, starting with an "JINIT”® statement, and ai processing 
section, starting with a ™)PROC" statement. 


The initialization section sets the control variable .HELP to the 
name of the corresponding help (tutorial) panel. This is the name 
of the panel which will be displayed if the user presses the Help 
PF key. Then the current value of variable PHA is tested. If it 
is blank Cor null), it is initialized to a default value (301). 


The processing section contains VER statements to verify that 
information entered by the user meets the following criteria: 


e The three name variables (LNAME, FNAME, and I) contain all 
alphabetic characters. 


° The area code (PHA) contains all numeric characters. 


° The local number (CPHNUM) contains three numeric characters, 
followed by a hyphen, followed by four numeric characters. 


EMPLOYEE RECORDS 


+ TYPE OF CHANGEZ===>_TYPECHG + (NEW, UPDATE, OR DELETE) 


EMPLOYEE NAME: 
LAST %=5=>_LNAME 
FIRST %===>_FNAME 
INITIALZ===>_I+ 


HOME ADDRESS; 
LINE 1 %== 
LINE 2 “%== 
LINE 3 “== 
LINE 4 4== 


ADDR1 
ADDR2 
ADDR3 
>_ADDR4 


> 
> 
> 


HOME PHONE : 
AREA CODE %===>_PHA+ 
LOCAL NUMBERZ===>_PHNUM —s + 


JINIT 
-HELP = PERSO32 
IF (&PHA = ° ') 
&PHA = 301 


PROC 
VER (&LNAME,ALPHA) 
VER (C&FNAME ,ALPHA) 
VER (&I,ALPHA) 
VER (&PHA,NUM) 
VER (&PHNUM,PICT, 'NNN-NNNN° ) 


JEND 


Figure 6. Sample Panel with Assignment, IF, and VER Statemants 
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When the DISPLAY service is invoked, a message may optionally be 
displayed with the panel, or superimposed on the panel that is 
currently displayed. Messages are referenced by message id. 
Several messages may be contained within each member of the mes- 
sage library. 


Each message consists of two lines. The first line contains the 
message id, and optionally: 


° Short message text, enclosed in apostrophes (') 
° Corresponding help panel Cif the user presses the Help PF key) 
° Audible alarm indicator (yes or no). 


The second line contains the long message text, enclosed in apos~- 
trophes. 


If a short message is specified, it will be displayed first in the 
upper right-hand corner of the screen. If the user presses the 
Help PF key, the long message will then be displayed on line 3 of 
the screen. If the user presses the Help key again, tutorial mode 
will be entered. 


If a short message is not specified, the long message will be dis- 
played first (on line 3). If the user then presses the Help key, 
tutorial mode will be entered. 


Substitutable parameters, consisting of a dialog variable name 
preceded by an ampersand (&), may appear anywhere within the short 
and long message text. Example: 

‘VOLUME &VOL NOT MOUNTED'® 


Figure 7 shows an example of a member in the message library. 
This member contains all message ids which begin with "EMPX21". 


EMPX210 ‘&TYPECHG INVALID' eHELP=PERSO33 .ALARM=YES 
"TYPE OF CHANGE MUST BE NEW, UPDATE, OR DELETE.’ 


EMPX213 ‘ENTER FIRST NAME' -HELP=PERS034¢ » ALARM=YES 
“EMPLOYEE NAME MUST BE ENTERED FOR TYPE OF CHANGE = NEW.’ 


EMPX214 "ENTER LAST NAME’ -HELP=PERS034 «ALARM=YES 
‘EMPLOYEE NAME MUST BE ENTERED FOR TYPE OF CHANGE = NEW.‘ 


EMPX215 ‘ENTER HOME ADDRESS’ -HELP=PERSO35 #£=.ALARM=YES 
"EMPLOYEE HOME ADDRESS MUST BE ENTERED FOR TYPE OF CHANGE = NEW.’ 


EMPX216 ‘AREA CODE INVALID’ »ALARM=YES 
"AREA CODE &PHA IS NOT DEFINED. PLEASE CHECK THE PHONE BOOK.’ 


EMPX217 ‘CHANGE COMPLETED' 
"EMPLOYEE &LNAME, &FNAME &I (2EMPSER) ADDED TO FILE.’ 


EMPX218 ‘CHANGE COMPLETED' ; 
"RECORDS FOR &LNAME, &FNAME &I (&EMPSER) UPDATED.’ 


EMPX219 ‘CHANGE COMPLETED’ 
"RECORDS FOR &LNAME, &FNAME &I (8EMPSER) DELETED.’ 


Figure 7. Sample Member in Message Library 
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TABLE SERVICES 
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Table services allow dialog variables to be permanently stored 
across sessions. A table is a two-dimensional array of informa- 
tion in which each column corresponds to a dialog variable, and 
each row contains a set of values for those variables. An example 
is shown in Figure 8. 


EMPSER 
598304 Roberston Richard 840-1224 


172397 Smith Susan 547-8465 
813058 Charles 338-9557 
395733 John 477-1776 
502774 Caruso Vincent 294-1168 


Figure 8. Sample Table 


In this table, the variables that define the columns are: 


EMPSER - Employee Serial Number 
LNAME - Last Name 

FNAME - First Name 

I - Middle Initial 

PHA - Home Phone: Area Code 
PHNUM - Home Phone: Local Number 


When a table is created, one or more columns (variable names) may 
be specified as keys for accessing the table. In the above exam- 
ple, EMPSER might be defined as the key variable for searching the 
table. Or EMPSER and LNAME might both be defined as the keys, in 
which case a row Would be found only if EMPSER and LNAME both 
match the current values of those variables. 


A table may also be accessed by one or more "argument" variables, 
which is similar to accessing by key, except that the search argu- 
ments may be dynamically defined. 


In addition, a table may be accessed by "current row pointer" 
(CRP). When a table is opened, the CRP is automatically positioned 
to TOP -- ahead of the first row. The table may be scanned by mov- 
ing the CRP forward or back and reading rows. The order of the 
one under control of the dialog function when new rows are 
added. 


When a row is retrieved from a table, the contents of the row are 
stored into the corresponding dialog variables. When arow is 
stored Cupdated or added), the current contents of the dialog var- 
iables are saved in that ron. 


For any service that retrieves a row, a list of variable names may 
be obtained to determine what variables were retrieved. For any 
service that stores a row, a list of variable names may be pro- 
vided. This allows the variables in the table to be extended 
beyond what was specified when the table was created. 


A table may be defined as temporary or permanent. A temporary 
table is created in virtual storage, and deleted upon completion 
of processing. A permanent table resides on direct access stor- 
age. It may be opened for update or for read-only access. An EN@ 
is automatically issued to prevent multiple access to a table 
which is being updated. 
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The following services operate on an entire table: 

TBCREATE Create a new table. 

TBOPEN Prepare a table for processing. 

TBQUERY Obtain information about a table. 

TBSAVE Save a permanent copy of a table without closing. 
TBCLOSE Close a table, and save a permanent copy. 

TBEND Close a table without saving. 

TBERASE Delete a table. 


Row Operations 


The following services operate on a row of the table: 


TBADD Add a new row to the table. 

TBDELETE Delete a row from the table. 

TBGET Retrieve a row from the table. 

TBPUT Update an existing row in the table. 

TBMOD Update a row in the table if it exists Cif the keys 


match); otherwise, add a new row to the table. 
TBEXIST Test for the existence of a row (by key). 


TBSCAN Search a table for a row that matches a list of 
"argument™ variables, and retrieve the row. 


TBSARG Establish a new search argument for use with TBSCAN. 
TBTOP Set CRP to TOP Cahead of the first row). 
TBBOTTOM Set CRP to BOTTOM and retrieve the last row. 


TBSKIP Move the CRP forward or back by a specified number of 
rows, and then retrieve a row. 


TBVCLEAR Set dialog variables (that correspond to variables in 
the table) to null. 


Table Display Service 


The following service displays information in a table and allows 
rows to be selected for processing. 


TBDISPL Display selected columns from a table. 


This service requires specification of a panel name, as well asa 
table name. The panel definition contains the non-scrollable 
text, including column headings. It also specifies the columns to 
be displayed, and whether each column is protected or unprotected 
Cuser modifiable). Typically, the left-most column is defined as 
a selection code. The code is interpreted by the dialog function 
to determine the particular processing for that row. 


When the table is displayed, the user may scroll up and down, and 
enter information in unprotected fields Cone row at a time). 
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File tailoring services read skeleton files from a library and 
write tailored output that may be used to drive other functions. 
A Sot ara ahd file tailoring is usad to generate job files for batch 
execution. 


The file tailoring output may be directed to a data set that has 
bean allocated by the dialog function, or it may be directed to a 
temporary data set provided by SPF. The name of the temporary 
data set is available in system variable ZTEMPF. 


Each skeleton file is read record by record. Each record is 
scanned to find any dialog variable names (preceded by an amper- 
Sours aoe a variable name is found, its current value is sub- 
stituted. 


Skeleton file records may also contain statements that control 
processing. These allow the user to set dialog variables, imbed 
other skeleton files, conditionally include records, and iter- 
atively process records in which variables from each row of a 
table are substituted. 


A sample skeleton file is shown in Figure 9. It contains JCL 
statements for an assembly and optional load-go. The tailored 
output could be submitted to the background for execution. 


The sample skeleton references several dialog variables 
CASMPARMS, ASMIN, MEMBER, etc.). It also illustrates use of 
select statements ")JSEL"™ and ")ENDSEL® to conditionally include 
records. The first part of the example has nested selects to 
include concatenated macro libraries if the library names have 
been specified by the user (i.e., if variables ASMMAC1] and ASMMAC2 
are not equal to the null variable 2). 


In the second part of the example, select statements are used to 
conditionally execute a load-go step. An imbed statement, ")IM", 
is used to bring in a separate skeleton for the load-go step. 

The file tailoring services are: 


FTOPEN Prepares the file tailoring process, and specifies 
whether the temporary data set is to be used for output. 


FTINCL Specifies the skeleton to be used, and starts’ the 
tailoring process. 


FTCLOSE Ends the file tailoring process. 


FTERASE Erases (deletes) an output file created by file 
tailoring. 
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77%SM EXEC 
// 

7/7SYSIN DD 
//SYSLIB DD 
YSEL &ASMMACI 
(7 DD 
SEL &ASMMAC2 
// OD 
JENDSEL 
JENDSEL 
/7SNSUT1L = DD 
//7SYSUT2 OD 
//SYSUT3 OD 
//7SYSPRINT OD 


PGM=IFOX00 ,REGION=1 28K, 
PARM=( &ASMPARMS ) 
DSN=&ASMIN( &MEMBER ) ,DISP=SHR 
DSN=SYS1.MACLIB,DISP=SHR 

== &Z 

DSN=&ASMMAC1 ,DISP=SHR 

ss £Z 

DSN=&ASMMAC2 »DISP=SHR 


UNIT=SYSDA,SPACE=(CYL,(5,2)) 
UNIT=SYSDA,SPACE=(CYL,(2,1)) 
UNIT=SYSDA,SPACE=(CYL,(2,1)) 
SYSOUT=( &ASMPRT ) 


10M IF USER SPECIFIED "GO", WRITE OUTPUT IN TEMP DATA SET 
1CM THEN IMBED "LINK AND GO" SKELETON 
YSEL &GOSTEP = YES 

//SYSGO DD DSN=&&&&OBJSET,UNIT=SYSDA,SPACE=(CYL,(2,1)); 


4/ 
JIM LINKGO 
JENDSEL 


JCM ELSE (NOGO), NRITE OUTPUT TO USER DATA SET 
SEL &GOSTEP = 
//5NSGO DD DSN=&ASMOUT( &MEMBER ) ,DISP=OLD 


JENDSEL 
77% 


DISP=(MOD,PASS) 


NO 


Figure 9. Sample Skeleton File 
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The EDIT and BROWSE interface services allow a dialog function to 
invoke the SPF editor or browse program, which are part of the 
program development facility. These services raquire speci fica~ 
tion of a data set name (Cand member, if applicable). The entry 
panel, which is displayed if edit or bronse is selected from the 
primary option menu, is bypassed. 


The LOG service allows a dialog function to write a message to the 
SPF log file. The end user may specify whether the log is to be 
printed, kept, or deleted when SPF is terminated. 


The CONTROL service allows a dialog function to condition SPF to 
expect cartain kinds of display output, or to control the disposi- 
tion of errors encountered by SPF services. 


The display conditions are: 


LINE Expect line output, not generated by the dialog (e.g.; 
generated by execution of a TSO command). Optionally, 
the starting line may be speci fied. 


REFRESH Refresh the entire screen on tha next display. 
Typically used before or after invoking soma other 
full-screen application which is not using SPF display 
services. 


SM Transfer to TSO Session Manager mode on the next line 
output. 


NONDISPL Do not display the next panel (process the panel 
without actually displaying it, and simulate the ENTER 
or End key.) 


The disposition of errors may be controlled as follows: 


CANCEL Terminate the dialog function on a error Creturn code 
12 or higher from any service). A message is displayed 
and logged prior to termination. 


RETURN Return control to the dialog function on all errors 
(with appropriate return code). A message id is stored 
in system variable ZERRMSG, which may be used by the 
dialog function to display and/or log a message. 


The default disposition is CANCEL. If a dialog function sets the 
disposition to RETURN, the change affects only the current func~y 
tion. It does not affect lower level functions invoked via the 
SELECT service, nor a higher level function when the current funcy 
tion completes. 
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The SPF program development facility is designed to increase pro- 
grammer productivity in an interactive environment. It can be 
used either by an individual programmer, or by many programmers 
working together ona project. Significant features include: 


e Support for multilevel programming Libraries. Facilitates 
maintenance and tracking of program segments at varying ver- 
sion and modification lavels. 


e Full-screen, context editing. Allows additions and changes 
to multiple lines in a single interaction. Simple 
one-character edit commands are used for inserting, deleting, 
duplicating, or rearranging lines of source data. 


e Forward, backward, and sideways scrolling of source data or 
listings, plus the ability to locate information by character 
string or line number. 


e Utilities for specification and maintenance of SPF libraries, 
data sets, catalogs, and DASD volumes. 


e Interface to standard language processors (compilers, assem- 
bler, and linkage editor) for execution in the foreground or 
background. 


e Document preparation support. Includes text editing features 
wes an interface to the SCRIPT/VS Document Composition Facil- 
ity. 


e Online tutorial for instruction and reference -- especially 
valuable for the occasional or novice user. 


The program development facility supports both structured and 
conventional programming techniques. 


Structured programming emphasizes the use of segmentation and 
indentation. A source program normally consists of a large number 
of relatively small segments. The segments are stored as separate 
members of a programming library. Within a segment, source state- 
ments are block-indented under each "IF-THEN-ELSE™ or "DO-WHILE™ 
to show the control structure. Features which are specifically 
oriented toward structured programming include: 


e ° Ease of segmentation changes. One segment (member) can easi- 
ly be split into multiple segments, or multiple segments can 
be merged into one. 


® Ease of indentation changes. Single statements or blocks of 
statements can easily be shifted left or right by a specified 
number of column positions. 


e Insert in context. A "DO-END" pair, for example, may be coded 
on consecutive lines, and then space can be opened between the 
two lines to allow insertion of a block of code. 


e Visual verification aids. A block of code may be temporarily 
excluded from display so that the space which it occupies on 
the screen is closed up. This facilitates visual verifica- 
tion of the control structure, particularly when the length 
of a segment exceeds the screen size. 
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GENERAL DESCRIPTION 


DISPLAY 


Following is a description of features that are common across the 
various processing options of the program development facility. 


FORMAT 


Four basic types of display presentations are used: 


1. Selection Menus ~- The user selects from a list of options by 
typing a one-character code and pressing the ENTER key. Exam- 
ple: The SPF primary option menu (Figure 10). 


2. Entry Panels - The user supplies parameters by filling in 
labeled fields. In many cases, fields are pre-entered based 
on what the user last entered. Example: The browse entry 
panel (Figure 11). 


3. Member Selection Lists ~ Displays a list of members ina pro- 
gramming library. The user may select a member by entering a 
one-character code in front of the appropriate member name. 
Figure 12 shows an example of a member list on which the user 
has selected member COINS. 


4. Data Display - Displays source code or output listings. 
Figure 13 shows an example of the bromse display. 


All menus and panels are formatted to fit on a 24 line by 80 char- 
acter screen. On a 3278 Model 3 or 4, scrollable data will occupy 
the full length of the screen (32 or 43 lines). 


On a 3278 Model 5, information is normally displayed in "default™ 
mode (24 by 80) with the same size characters as other models. 
Browse and edit data that is wider than 80 characters is displayed 
with the smaller "native™ mode characters (up to 132 per line). 


The first three lines of each display are formatted as follows: 


line 2 Prompt/Input 


The title area (line 1) idantifies the function being performed 
and, where appropriate, the library or data set name, member name, 
version number, and modification level. The short message area 
Cline 1) is used to indicate: 


e Current line (browse) and column positions (browse and edit) 
° Successful completion of a processing function 
® Error conditions Caccompanied by audible alarm). 


The prompt/input area (line 2) is used to enter an option 
selection or command. In cases where no option selection or com- 
mand is applicable, this area contains a prompt. The scroll area 
Cline 2) contains the current scroll amount whenever scrolling is 
applicable. The scroll amount may be overtyped by the user (see 
"Scrolling™). 


The long message area (line 3) is used to display an explanation 
of error conditions upon request (sea “Help Information"). 
Normally this line is blank on menus and panels, contains column 
headings on member selection lists, and is treated as part of the 
data area on data displays. 
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(.. 
Sines 


SELECT OPTION == 

JOSLIN 
SPF PARMS SPECIFY TERMINAL AND SPF PARAMETERS TIME 12:47 
BROWSE DISPLAY SOURCE DATA OR OUTPUT LISTINGS TERMINAL - 3277 
EDIT CREATE OR CHANGE SOURCE DATA PF KEYS 12 
UTILITIES PERFORM SPF UTILITY FUNCTIONS 
FOREGROUND - COMPILE, ASSEMBLE, LINK EDIT, OR DEBUG 
BACKGROUND - COMPILE, ASSEMBLE, OR LINK EDIT 
COMMAND ENTER TSO COMMAND OR CLIST 
SUPPORT TEST DIALOG OR CONVERT MENU/MESSAGE FORMATS 
TUTORIAL DISPLAY INFORMATION ABOUT SPF 
EXIT TERMINATE SPF USING LIST/LOG DEFAULTS 


0 
l 
2 
3 
G 
5 
6 
7 
T 
D4 


PRESS END KEY TO TERMINATE SPF 


Figure 10. Primary Option Menu 


BROWSE = ENTRY PANEL weaeweeweeeeoee wee we wwe we eee ee ee 
ENTER/VERIFY PARAMETERS BELOW: 


SPF LIBRARY 
PROJECT 
LIBRARY 
TYPE 
MEMBER 


(BLANK FOR MEMBER SELECTION LIST) 
OTHER PARTITIONED OR SEQUENTIAL DATASET: 

DATASET NAME 

VOLUNE SERTAL (IF NOT CATALOGED ) 


DATASET PASSWORD (IF PASSWORD PROTECTED ) 


Figure li. Browse - Entry Panel 
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BROWSE - SPFDEMO.MYLIB.PLI ---------~-~-- ~-----~-~----------------------------- 
COMMAND INPUT ===> SCROLL ===> PAGE 


NAME VER.MOD CREATED LAST MODIFIED SIZE MoD ID 


ACCOUNT 
ACCTL 
ACCT2 

S COINS 
COMPX 
COMPY 
DCLS 
LISTNEW 
MAIN 
TESTDIR 
UPDATE 


01.00 
01.01 
01.00 
01.04 
01.00 
01.01 
01.00 
01.02 
01.00 
01.02 
01.00 


79/01/09 
79/01/09 
79/01/09 
79/04/24 
79/01/09 
79/01/14 
79/04/23 
79/04/23 
79/01/09 
79/04/23 
79/01/09 


79/01/09 
79/04/23 
79/01/09 
79/04/28 
79/01/09 
79701716 
79/04/23 
79/05/06 
79/01/09 
79/05/06 
79/01/09 


17:07 
14:52 
17:07 
16:20 
17:08 
12:30 
15:14 
15:00 
17:08 
17:04 
17:08 


21 
99 
20 
19 
44 
13 
20 
17 

ra 
30 
13 


fea 
gagoeocororeooesa7 


HOSTETL 
HOSTETL 
HOSTETL 
JOSLIN 
JOSLIN 
JOSLIN 
SILVA 
EKMAN 
EKMAN 
HOSTETL 
EKMAN 


3634 END 343% 


Figure 12. Browse ~ Member Selection List 


BROWSE - SPFDEMO.MYLIB.PLI(COINS) - 01.04 LINE 00000 COLS 001 080 
COMMAND INPUT ===> _ SCROLL ===> PAGE 
J3kHEEBHEUBHBHHHOBRHHHOHHEOHHEEEHEHEE TOP OF DATA x2¢3¢st636 2s ENENR-CAPS ON 
COINS: 00010001 
PROCEDURE OPTIONS (MAIN); 00020000 
DECLARE 00030000 
COUNT FIXED BINARY (31) AUTOMATIC INIT (1)> 00040000 

HALVES FIXED BINARY (31), 00050000 

QUARTERS FIXED BINARY (31), 00060003 

DIMES FIXED BINARY (31), 00070000 

NICKELS FIXED BINARY (31), 00080004 
SYSPRINT FILE STREAM OUTPUT PRINT; 00090000 

DO HALVES = 100 TO QO BY -50;3 00100000 

DO QUARTERS = (100 - HALVES) TO 0 BY -25;3 00110000 
00120000 
00130000 


DO DIMES = ((100 - HALVES - QUARTERS)/10)%10 TO 0 BY -103 
NICKELS = 100 - HALVES - QUARTERS - DIMES; 
PUT FILE(SYSPRINT) DATACCOUNT,HALVES, QUARTERS, DIMES, NICKELS) 300140000 


COUNT = COUNT + 13 
END; 
END; 


00150000 
00160000 
00170000 
ENDs 00180000 

END COINS; 00190001 
EH RBHBEBRHHHBHHHBHHEORHHEHEHEHEHE BOTTOM OF DATA xs¢203036303¢3606 2000 0300063080288-CAPS ON-26 


Figure 13. Browse ~- Data Display 
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SPF LIBRARIES 


An SPF library is a collection of code or data units, called mem- 
bers. Each library generally contains members with the same type 
of information. Figure 14 shows a sample set of five SPF 
libraries which contain Assembler source, COBOL source, object 
modules, load modules, and SCRIPT documentation. 


COBOL OBJ 


Figure 14. SPF Library Organization 


In the TSO environment, each SPF library is a cataloged parti- 
tioned data set, with a three-level name of the form: 


'project~name.library-name.type’ 
where -- 


e "“project-name"™ is the common identifier for all libraries 
belonging to the same project. 


° "library-name" identifies the particular set of libraries, 
such as MASTER, TEST, or RON. 


° "type" identifies the type of information in the library; 
such as ASM, COBOL, OBJ, LOAD, or SCRIPT. Except for OBJ and 
LOAD, the SPF type qualifier need not conform to the standard 
TSO naming conventions. 


Most projects will require a hierarchy of related libraries to 
maintain effective version control over the programming develop- 
ment process and to reduce contention in library usage. Figure 15 
shows a sample three-level hierarchy for a project, consisting of 
a set of master libraries, a set of test libraries, and three sets 
of development (private) libraries identified by user id. 


New members or members undergoing changes will generally reside 
in the development libraries. A test library may be used to accu- 
mulate members which have been unit tested and are ready for inte~- 
gration test. A master library contains fully tested members, 
which may correspond to a previously released version of the pro- 
gram. Typically, a higher degree of control is maintained over 
the higher level libraries than the development libraries. 
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Figure 15. Hierarchy of SPF Libraries 


SPF allows concatenation of up to four SPF libraries during source 
editing, compilation, assembly, link edit, or SCRIPT/VS process~ 
ing. Generally, the lowest level library is concatenated ahead of 
the next higher level library, and so on, in bottom-to-top order. 
For the hierarchy shown in Figure 15, a typical concatenation 
sequence might be library BOB, followed by TEST, followed by MAS- 
TER. The concatenation applies to libraries of the same type, and 
is restricted to libraries which belong to the same project. 


The purpose of concatenation during editing is to provide down- 
ward copying of a member from a test or master library to a davel- 
opment library. The edited member is saved in the development 
library (the first library in the concatenation sequence), while 
the unchanged version remains in the test or master library. When 
the new version is fully tested, it may be promoted back to a 
higher leval Library by maans of the move/copy utility. 


The purpose of concatenation during language processing is to 
facilitate inclusion of source segments via INCLUDE or COPY 
statements (Cor SCRIPT "imbed”™ controls), and to allow debugging 
of new or modified programs without altering the contents of the 
test or master libraries. The output from a compilation or assem- 
bly Cobject module) or link edit Cload module) is stored in the 
lowest level OBJ or LOAD library (the first library in the concat- 
enation sequence). 
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( PARAMETER SPECIFICATION 


Several entry panels require specification of the following: 


e Library and data set names 
e Data set password (if applicabla) 
e Job statement information (for submitting background jobs). 


These are described in the following paragraphs. 


ibrary a a S Name 


To specify a member of an SPF library, the user must enter a 
project name, library name, type qualifier, and member name. Each 
of these may contain up to eight alphameric characters, of which 
the first character must be alphabetic. 


SPF panels prompt the user for each component of the library iden- 
tification as follows: 


SPF LIBRARY: 
PROJECT 
LIBRARY 
TYPE 
MEMBER 


ua a 
VNVVV 


cue u 


(BLANK FOR MEMBER SELECTION LIST) 


For convenience, any cataloged data set (sequential or parti- 

tioned) with a three-level name may be entered in this manner, 

even if the three components of the data set name do not actually 
identify project, library, and type. For partitioned data sats, 

b aad if the member name is not specified, a member selection list will 
be displayed. 


ion: In foreground and background processing, options 4 
and 5, only a partitioned data set may be specified, and the mem- 
ber name must be specified. 


Some panels allow a concatenated sequence of up to four SPF 
libraries. For example: 


SPF LIBRARY: 
PROJECT 


LIBRARY 
TYPE 
MEMBER 


In this example, three libraries would be concatenated in the fol- 
lowing order: 


SAMPLE.MYOWN.COBOL 
SAMPLE.TEST.COBOL 
SAMPLE.MASTER.COBOL 


It is a user responsibility to insure that the concatenated 


libraries have consistent record formats, logical record lengths, 
and block sizes. 
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Partitioned and sequential data sets may also be spacified using 
standard TSO syntax, as follows: 


OTHER PARTITIONED EQUENTIAL DATA SET: 
DATA SET NAME 


VOLUME SERIAL (IF NOT CATALOGED) 


Any fully qualified data set name may be entered, enclosed within 
apostrophes. If the apostrophes are omitted, the TS50 user prefix 
is automatically left-appended to the data set name. For parti- 
tioned data sets, a member name enclosed in parentheses may follow 
the data set name. For example: 


"SYS1.PROCLIBCASMHC)' 


If the member name (Cand parentheses) are omitted, a member 
selection list will be displayed. 


If both an SPF library and "other™ data set name are specified on 

the same panel, the "other" data set name is’ used. In other 

eee to specify an SPF Library, the other data set name must be 
lank. 


The volume serial parameter may specify a real DASD volume or a 
virtual volume residing on an IBM 3850 Mass Storage System. To 
access 3850 virtual volumes, the user must also have MOUNT author- 
ity (see TSO ACCOUNT command). 


Note: SPF does not support multivolume data sets. 


SPF supports the use of OS password protection. Any data set may 
be protected for read-only or read/write access. More than one 
password may be assigned to the same data set. A data set that is 
read/write protected, for exampla, might allow several authorized 
users to read it, but only one user to write. 


A data set password may be specified in the following manner: 


DATA SET PASSWORD ===> (IF PASSWORD PROTECTED) 


A non-display input field is used so that the password will not 
appear on the screen. For entry panels that allow specification 
of a concatenated sequence of libraries, the password applies to 
all data sets in the concatenation sequence. 


Note: SPF may be used with either the TSO/VS2 Programming Control 
Facility (PCF) or the Resource Access Control Facility (CRACF). 
PCF and RACF provide extensive facilities for protecting data set 
security. With PCF or RACF the user should not attempt to enter a 
password on the SPF panels, since both of these facilities rely on 
the TSO user id and Clogon) password to identify the user and 
check for proper authorization. 
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SPF supports submission of background jobs for printing and lan- 
guage processing. Before submitting a background job, the user 
must supply a job statement. For this purpose, four lines are 
provided on each job submission panel. The first time a job sub- 
ras panel is displayed, the job statement information appears 
as follows: 


EMENT INFORMATION: 
//user-idA JOB (ACCOUNT), "NAME' 


The pre-entered job name consists of the user id right-appended 

with the letter "A™. The last character of the job name is auto- 

matically incremented to "B", "C", etc., each time the job state- 

ment information is used. The user may change the last character 

of the job name to a numeric digit, rather than a letter, in which 

ete the last character will be cycled from 0 to 9, rather than A 
o 2. 


The user may overtype the entire job name, if desired, but auto- 
matic incrementing of the last character is suspended unless the 
job name starts with the user id. 


The remaining job statement information must be entered by the 
user the first time a background job is submitted. The lines con- 
taining "//%" may be used as continuation lines (by changing the 
RW/7*" to "//"), or they may be used to enter other JCL statements, 
such as a JOBLIB DD statement. If these lines are not needed, 
Ack may be blanked out. Blank lines are not submitted to the job 
stream. 


er Pa r 


SPF pre-enters appropriate information on panels according to 
what was last entered by the user. In many cases, default values 
are provided if the user has not specified otherwise. This 
includes the following types of information: 


Project name, library name(s), and type 

Job statement information 

SYSOUT class for printed output 

Defaults for list/log allocation and processing 
Terminal characteristics and PF key definitions 

Edit profiles, including mask, tabs, and bounds 
Processing options for each of the language processors 
Data set allocation/information parameters 


eeeceétée @ 


This information is autonatically maintained from one session to 
another. A new user will have to enter certain information the 
first time it appears. But from that point on, the user simply 
verifies the information and makes whatever changes are desired 
before proceeding. 
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The program access (PA), and program function (PF) keys are used 
to request commonly used operations. Keys that are not needed for 
SPF-defined key operations may be equated to edit and browse pri- 

pe i arta or edit line commands, using the SPF parms option 
option 0.3). 


The default key arrangement for the 3-by-4 key pad (Cright-hand 
side of the keyboard) is shown in Figure 16. These are PF keys 
1-12 on a 12-key terminal, or keys 13-24 on a 24-key terminal. 


For 24-key terminals, PF keys 1-12 have the same defaults as keys 
13-24. It is strongly recommended that users of 24-key terminals 
continue to use the key pad (13-24) for SPF-defined operations, 


and redefine PF keys 1-12 to edit and browse commands. 
PF1 / 13 PF2 7 14 PF3 / 15 
HELP SPLIT END 


PFG / 16 PFS / 17 PF6 / 18 
RETURN FINO CHANGE 
| PF7 719 PF8& / 20 PF9 / 21 
ee 
(UP) ( DOWN ) 
PFLO / 22 PF1l / 23 PFI2 7 24 
CURSOR 


The two PA keys are defined as follows. They may not be redefined 
by the user. 


ATTENTION CPA1) This key is logically disabled whenever the 
keyboard is unlocked, except during execution of 
a TSO comers under SPF (foreground or command 
option). 


RESHOW CPA2) Redisplays the contents of the screen. May be 
useful if the ERASE or CLEAR key was pressed 
accidently, or if unwanted information has been 
typed but ENTER Cor a PF key) has not yet been 
pressed. Note that SPF does not support use of 
the Field Mark character (same key as PA2). 


PAl 


ATTENTION 


——— —_—— 


(LEFT) (RIGHT) 


Figure 16. Default Program Key Arrangement 
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The SPF-defined PF key operations are described below. Sea 
Figure 16 for the default key assignments. 


HELP Displays additional information about an error message 
or tutorial information about SPF commands and options. 


SPLIT Causes split screen mode to be entered, or changes the 
location of the split line Csee "Split Screen”). 


END Terminates the current operation and returns to the 
previous menu. If the primary option menu is displayed, 
this key terminates SPF. 


RETURN Causes an immediate return to the primary option menu, 
bypassing any intermediate menus. CLogically equiv- 
alent to repeated use of the End key.) May also be used 
to go directly from one option to another, without dis- 
playing the primary option menu, as follows: In any 
panel input field or primary command line, enter an 
equal sign (=) followed by a primary option. Then press 
the Return PF key rather than the ENTER key. 


FIND Repeats the action of the previous FIND command or the 
FIND part of the most recent CHANGE command Capplies to 
browse and edit only). 


CHANGE Repeats the action of the previous CHANGE command 
Capplies to edit only). 


UP Causes a scroll up (see "Scrolling™). 
DOWN Causes a scroll down (sea "Scrolling™). 
SWAP Moves the cursor to wherever it was’ previously 


positioned on the other logical screen (see "Split 
Screen"). 


LEFT Causes a scroll left (see "Scrolling™). 
RIGHT Causes a scroll right (see "Scrolling™). 


CURSOR Moves the cursor to the first input field on line 2 
(normally, the option selection or command § input 
field). Pressing this PF key again causes tha cursor to 
be moved to the second input field on line 2, if any 
€normally the scroll amount field). 


PRINT Causes a "snapshot" of the screen image to be recorded 
in the SPF list file. 


PRINT-HI Same as PRINT except that high intensity characters on 
the screen are printed with ovearstrikes to simulate the 
dual intensity display. Should not be used if list out- 
put is to be printed on a "local" 328x printer or other 
eee er does not support suppress-space carriage 
control. 


NOP Causes the PF key to be functionless. 


The PRINT, PRINT-HI, and NOP functions have no default PF key 
assignments. 


The only PF key function that is required is the End key. Other 


keys may be assigned to edit and browse commands, or to PRINT, 
PRINT-HI, or NOP. 


General Description 31 


SCROLLING 


32 


During edit and browse, the information to be displayed will gen- 
erally exceed the screen size. Scrolling allows the screen "win- 
dow" to be moved up, down, left, or right across the information. 
A member list can also be scrolled up and down, if it exceeds a 
single screen langth. 


Four program function (PF) keys are used for scrolling -~- one for 
each direction. Whenever scrolling is allowed, a scroll amount is 
displayed at the top of the screen (line 2). This determines the 
number of lines Cor columns) scrolled with each use of a Scroll PF 
key. The user may change the scroll amount by moving the cursor 
to the scroll field and overtyping the displayed amount. Valid 
scroll amounts are: 


e A number from 1 to 9999 - specifies the number of lines (Cup or 
down) or columns (left or right) to be scrolled. 


e PAGE - specifies scrolling by one page. 
° HALF - specifies scrolling by a half page. 


e MAX - specifies scrolling to the top, bottom, laft margin, or 
right margin, depending upon which Scroll PF key is used. 


° CSR - specifies scrolling based on the current position of the 
cursor. The line or column indicated by the cursor is moved 
to the top, bottom, left margin, or right margin of the 
screen, depending upon which Scroll PF kay is used. If the 
cursor is not in tha body of the data, or if it is already 
positioned at the top, bottom, left margin, or right margin, a 
full page scroll will occur. 


For scrolling purposes, a “page” is defined as the amount of 
information currently visible on the logical screen. In split 
screen mode, for example, a browse display might have 12 lines by 
80 columns of scrollable data. In this case, a scroll amount of 
HALF would move the window up or down by 6 lines, or right or left 
by 40 columns. 


For member lists and browsing, the scroll amount is initialized to 
PAGE. For editing, the scroll amount is initialized to HALF. When 
the user overtypes the amount, the new value remains in effect 
until it is again changed by the user, or until a new member list 
or new data is displayed. The value MAX is an exception; follow- 
ing a MAX scroll, the scroll amount reverts to its previous value. 


Any valid scroll amount can also be entered in the command input 
field and used in conjunction with a Scroll PF key. For example: 


If a Scroll PF key is pressed, the value in the command area will 
be used, overriding thea normal scroll amount, without causing a 
change to the scroll field. This results in a one-time overrida; 
the value in the command area is blanked out after scrolling 
occurs. 


If some key other than a Scroll PF key is pressed, the value in 
the command area will be interpreted as a command and will proba- 
bly result in an error message. 
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OVERTYPING OF SCROLL AND MULTIPLE CHOICE PARAMETERS 


To reduce keystrokes, the scroll amount field can be changed by 
overtyping the first character(s) only: 


e To change the scroll amount to PAGE, HALF, MAX, or CSR only 
the first character need be overtyped with "P", "H™, "M", or 
"C" respectively. 


® In the scroll amount field, any alphabetic characters follow- 
ecg ee are ignored. For example "SAGE" is interpreted 
as é 


The same rule applies to multiple choice parameters in cases where 
the first letter uniquely defines the option. Examples: 


To change these options to YES or DELETE, only the first character 
need be overtyped with "Y" or "D" respectively. 


SPLIT SCREEN 


Split screen mode allows the user to partition the display screen 
into two logical screens. The top and bottom screens are treated 
as though they were independent terminals. Functions that can be 
performed simultaneously on two separate terminals can be done on 
the top and bottom screens. Functions that are in conflict on two 
separata terminals (editing the same member of an SPF library or 
other partitioned data set, or editing the same sequential data 
set) will also be in conflict when simultaneously attempted on the 
top and bottom screens. 


Split screen mode is entered by pressing the Split PF key, but 
first the user moves the cursor to the desired location for the 
split. The line containing the cursor will become the split line 
and will be identified by a row of periods. When the Split PF key 
is pressed, all lines below the cursor are treated as the bottom 
screen. The first display to appear on the bottom screen is the 
primary option menu. An example is shown in Figure 17. 


Note: Since only one logical screen is active at a time, the user 
cannot split the screen while executing a foreground compilation 
or a TSO command. 


The split location may be repositioned at any time by moving the 
cursor to the desired line and pressing the Split PF key again. 
Repositioning may be required to bring an entire panel or tutorial 
page into view. 


In split screen mode, one or the other of the logical screens is 
considered active at any point in time. Any interrupts, such as 
the operation of program function keys, are interpreted as having 
meaning for the active screen. The location of the cursor identi- 
fies which of the two screens is active. To switch from one 
screen to the other, the cursor movement keys may be used or the 
Swap PF key may be pressed. 


In addition to moving the cursor to the other logical screen, the 
Swap PF key will automatically reposition the split if either log- 
ical screen is less than five lines long. For example, if the 
split occurs at the third line down from the top and the cursor is 
on the bottom screen, pressing the Swap PF key will move the cur- 
sor to the top screen and reposition the split to the third line 
up from the bottom. This allows the use of two screens in 
"flip-flop”™ mode, with each logical screen consuming nearly all 
lines of the physical screen. 
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BROWSE - SPFDEMO.MYLIB.PLI(COINS) - 01.04 LINE 00000 COLS 001 080 
COMMAND INPUT === SCROLL ===> PAGE 
IEIE-HE HG IEICE IEE HE HE IEEE HE IE HEHE TE 9G 96-96-90 9 90 96 90989 TOP OF DATA si REN-CAPS ON-%3 
COINS: 00010001 
PROCEDURE OPTIONS (MAIN); 00020000 
DECLARE 00030000 
COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 00040000 
HALVES FIXED BINARY (31), 00050000 
QUARTERS FIXED BINARY (31)> 00060003 


SELECT OPTION ===> 

USERID 
SPECIFY TERMINAL AND SPF PARAMETERS TIME 
DISPLAY SOURCE DATA OR OUTPUT LISTINGS TERMINAL 
CREATE OR CHANGE SOURCE DATA PF KEYS 
PERFORM SPF UTILITY FUNCTIONS 
COMPILE, ASSEMBLE, LINK EDIT, OR DEBUG 
COMPILE, ASSEMBLE, OR LINK EDIT 
ENTER TSO COMMAND OR CLIST 
TEST DIALOG OR CONVERT MENU/MESSAGE FORMATS 
DISPLAY INFORMATION ABOUT SPF 
TERMINATE SPF USING LIST/LOG DEFAULTS 


SPF PARMS 
BROWSE 
EDIT 
UTILITIES 
FOREGROUND 
BACKGROUND 
COMMAND 
SUPPORT 
TUTORIAL 
EXIT 


0 
l 
2 
3 
& 
5 
6 
7 
T 
x 


PRESS END KEY TO TERMINATE SPF 


Figure 17. Split Screen Example 


Split screen mode is terminated by ending SPF processing on either 
logical screen (Ci.e., by pressing the End PF key or by entering 
option "X" when the primary option menu is displayed). The 
remaining logical screen is then expanded to its full size. Split 
screen may also be terminated by typing =X Cexit option) in the 
command input area and pressing the Return PF key. 


HELP INFORMATION 
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The help function allows the user to obtain additional informa- 
tion about a message that has been displayed in the upper 
right-hand corner of the screen, or general information about an 
SPF command or option. 


If a message is displayed, pressing the Help PF key causes a 
one-line explanation to be displayed. If this explanation is not 
sufficient, the user may obtain further information by pressing 
the Help key again. This causes an entry into the appropriate 
section of the tutorial. If a message is not displayed, the Help 
iP aat ee a direct entry into the appropriate section of the 
utorial. 


Once in the tutorial, the End PF key causes a return to the screen 
that was being viewed when the Help key was originally pressed. 
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LIBRARY ACTIVITY STATISTICS 


Under user option, the SPF editor will automatically generate and 
maintain the following activity statistics for each member of an 
SPF library or other partitioned data set. 


Version Number: Initialized to 1 when the member is created. 

Modification Level: Number of times this version has been 
modified. 

Creation Date: When this version was created. 


Date/Time Modified: When this version was last modified. 
Current No. Lines: Current size (number of records). 
Initial No. Lines: Initial size of this version. 


No. Modified Lines: Number of lines added or changed since this 
veal was created. (Zero for unnumbered 
ata. 


User Id: Wiho created or last updated this version. 


The version number and/or user id may be changed via the "reset 
SPF statistics” utility Coption 3.5). The statistics are dis- 
played next to each member name on member selection lists, and may 
be printed by requesting an “index listing™ via the library utili-~ 
ty Coption 3.1). 


LIST AND LOG FILES 


SPF helps the user obtain hardcopy listings of source modules. 
Under user option, a listing of any source module that is created 
or modified by the SPF editor may be automatically recorded for 
printing. Source listings and other types of printed output may 
also be obtained from the SPF utilities. A screen "snapshot" may 
be obtained by pressing the Print PF key. 


SPF also maintains a log of significant user activities, includ- 
ing a record of data sets (Cand members) that were modified via 
edit or utility options, foreground and background processing 
activity, and command entry. 


This information is accumulated in two temporary data sets, 
referred to as the SPF list and log files. They are allocated 
automatically whan needed. Once allocated, the list and log files 
remain open throughout the session. When the user terminates SPF, 
the contents of these files may be printed. 


The printed output may be directed to a system output device via 
submission of a background job, or it may be directed to a local 
IBM 3284, 3286, 3287, 3288, or 3289 printer. For local printing, 
the TSO Command Processor "DSPRINT®™ must be installed. 
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The SPF program development facility is invoked by entering the 
command “ISPF®. CAn SPF command may be established as an alias of 
ISPF). The first display is the primary option menu (Figure 18). 
The user may select an option by typing a one-character code in 
the option field and pressing the ENTER key, e.g., 


SELECT OPTION ===> 2 
to select the edit option. 


~-------------------- SPF-MVS PRIMARY OPTION MENU --------------------------- 
SELECT OPTION ===> _ 
USERID - JOSLIN 

0 SPF PARMS - SPECIFY TERMINAL AND SPF PARAMETERS TIME - 12:47 

1 BROWSE - DISPLAY SOURCE DATA OR OUTPUT LISTINGS TERMINAL ~ 3277 

2 EDIT - CREATE OR CHANGE SOURCE DATA PF KEYS - 12 

3 UTILITIES - PERFORM SPF UTILITY FUNCTIONS 

4 FOREGROUND - COMPILE, ASSEMBLE, LINK EDIT, OR DEBUG 

5 BACKGROUND - COMPILE, ASSEMBLE, OR LINK EDIT 

6 COMMAND - ENTER TSO COMMAND OR CLIST 

7 SUPPORT  - TEST DIALOG OR CONVERT MENU/MESSAGE FORMATS 

T TUTORIAL - DISPLAY INFORMATION ABOUT SPF 

X% EXIT - TERMINATE SPF USING LIST/LOG DEFAULTS 


PRESS END KEY TO TERMINATE SPF 


Figura 18. Primary Option Menu 


For options that have secondary level manus Coptions 0, 3, 4, 5, 
and 7), the user may bypass the second menu by typing two numbers, 
separated by a decimal point, on the primary option menu. For 
example, entering "3.1" on the primary menu has the same effect as 
entering "3" on the primary menu and "1" on the secondary menu. 


On initial entry, the user may also bypass the primary (and secu~ 
ondary) manus by entering an initial option as a parameter to the 
ISPF command. Examples: 


ISPF 2 - to go directly to edit 
ISPF 3.1 ~- to go directly to utility suboption 1 
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The SPF primary options are: 


e SPF PARMS - To specify SPF parameters and defaults, includ- 
ing: terminal type, number of program function (PF) keys, 
default pad character for input fields, allocation parameters 
oe gt dat dispositions for list and log files, and PF key 

efinitions. 


e BROWSE - To display source data or output listings. Browse is 
intended primarily for viewing large data sets such as com- 
piler listings or dumps. 


e EDIT - To create or change source data, including program 
code, test data, or documentation. Unlike browse, edit reads 
the selected member Cor entire sequential data set) into vir- 
tual storage and retains it there during edit operations. 


e UTILITIES - To print, rename, or delete library members or 
entire data sets; allocate data sets; move or copy data; dis~ 
play or print catalog listings or VTOCs; reset SPF library 
statistics; initiate hardcopy output; examine held SYSOUT 
data; or format SCRIPT/VS documentation. 


e FOREGROUND - To execute TSO prompters and language processing 
programs in the foreground, including: Assembler, COBOL, 
FORTRAN, PL/I Ccheckout or optimizer), PASCAL, linkage edi- 
tor, and COBOL or FORTRAN interactive debug. 


° BACKGROUND - To generate and submit JCL for background exe~ 
cution of IBM language processing programs, including: Assem- 
bler, COBOL, FORTRAN, PL/I Cecheckout or optimizer), PASCAL, 
and linkage editor. 


e COMMAND ~- To enter a TSO command or command procedure (CLIST) 
during execution of SPF. 


e SUPPORT - To test a panel or dialog function; set or examine 
dialog variables; convert old format selection and tutorial 
oo to nen format panels; or convert old format messages to 
new format. 


e TUTORIAL - To obtain immediate online instruction in the use 
of SPF. The tutorial may be viewed sequentially from begin- 
ning to end, or randomly by selecting topics from the table of 
contents or alphabetized index. The tutorial may also be 
entered from other SPF options by means of the Help PF key. 


To terminate SPF, the user must be out of split screen mode. Two 
termination options are available from the primary option menu: 


1. Option "X" may be entered. This terminates SPF with user 
defaults for processing list and log files, as specified via 
SPF parms Coption 0.2). 


Note: Option "X" may also be used with the Return PF key to 
immediately terminate split screen or, in single screen mode, 
to immediately terminate SPF from any menu or entry panel. 


2. The End PF key may be pressed to display the SPF termination 
panel for specification of list and log processing. 


The termination panel allows the user to specify whether the list 
and log files are to be printed via a background job or routed to 
a local printer, or deleted or kept without printing. If the 
files are to be printed, the destination (SYSOUT class or printer 
id) must be specified, as well as job statement information for 
background printing. 


Once the termination options have been entcred, the ENTER key is 
pressed to complete termination. The screen is cleared, one or 
more termination messages is displayed, followed by a READY mes- 


sage, and the user is returned to TSO. 
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MEMBER LISTS 


For any of the following options, a member selection list will be 
displayed if an SPF library or other partitioned data set is spec— 
ified but no member name is supplied: 


Browse 

Edit 

Library Utility 

Move/Copy Utility 

Reset SPF Statistics Utility 
SCRIPT/VS Utility 


An example of a member list display is shown in Figure 19. The 
member selection list also shows the SPF statistics for each mem- 
ber of an SPF library. 


BROWSE - SPFDEMO.MYLIB.PLI 
COMMAND INPUT ===> _ 
NAME VER.MOD CREATED 


SCROLL ===> PAGE 
LAST MODIFIED INIT MOD ID 


ACCOUNT 
ACCT1 
ACCT2 
COINS 
COMPX 
COMPY 
DCLS 
LISTNEW 
MAIN 
TESTDIR 
UPDATE 


01.00 
01.01 
01.00 
01.04 
01.00 
01.01 
01.00 
01.02 
01.00 
01.02 
01.00 


79/01/09 
79/01/09 
79/01/09 
79/04/24 
79/01/09 
79/01/14 
79/04/23 
79/04/23 
79/01/09 
79/04/23 
79/01/09 


79/01/09 
79/04/23 
79/01/09 
79/04/28 
79/01/09 
79/01/16 
79/04/23 
79/05/06 
79/01/09 
79/05/06 
79/01/09 


17:07 
14:52 
17:07 
16:20 
17:08 
12:30 
15:14 
15:60 
17:08 
17:04 
17:08 


21 
193 
20 
19 
44 
13 
20 
13 
4 
43 
13 


- 
eoocrordoaorod so 


HOSTETL 
HOSTETL 
HOSTETL 
JOSLIN 
JOSLIN 
JOSLIN 
SILVA 
EKMAN 
EKMAN 
HOSTETL 
EKMAN 


3% END 


Figure 19. Member List Display 


The member list may be scrolled up and down by means of the Scroll 
PF keys. In addition, a LOCATE command may be entered in the com 
mand input field on line 2 of any member list display. 


For browse, edit, and the SCRIPT/VS utility, one member at a time 
may be selected from the list, aither by entering the single char- 
acter "S®" jin front of the desirad member name, or by entering a 
SELECT command in the command input field on linea 2. 


For the other utility options, multiple members may be selected 
from the list. A single character code may be typed in front of 
one or more mamber names before pressing the ENTER key. For the 
move/copy and reset utilities, the selection code is "S". For the 
library utility, the allowable codes are "P" (for print), "R”™ (for 
rename), "D" Cfor delete), and "B" (for browse). 
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F_PARMS COPTION 0) 


The SPF parms option allows the user to display and change a vari- 
ety of SPF parameters at any time during the session. Changes 
remain in effect until the user changes the parameter again, and 
are remembered across sessions. The parameter options menu is 
shown in Figure 20. 


SELECT OPTION ===> 


1 TERMINAL - SPECIFY TERMINAL CHARACTERISTICS 
2 LIST/LOG - SPECIFY SPF LIST AND LOG DEFAULTS 
3 PF KEYS - SPECIFY PF KEYS FOR 3277 TERMINAL WITH 12 PF KEYS 


Figure 20. SPF Parameter Menu 


The SPF parms option allows the user to spaci fy: 
1. Terminal Characteristics 


e Type of terminal 
e Number of program function keys on the terminal (12 or 24) 
e Default pad character for input fields. 


2. List and Log Defaults 


Default disposition (print, keep, or delete) 
Method of printing and destination of output 
Lines per page 

Data set allocation parameters. 


3. Program Function (PF) Key Assignments 


e For a 3277 Cor 3275) with 12 PF keys 
° For a 3278 Cor 3276 or 3279) with 12 PF keys 
° For a 3278 Cor 3276 or 3279) with 24 PF keys 


Before assigning PF keys Coption 0.3), the user should ensure that 


the correct terminal type and number of PF keys has been speci fied 
via option 0.1. 
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The PF key assignment panel for a 24-key terminal is shown in 
Figure 21. The user may equate a PF key to an edit or browse pri- 
mary command, or to an edit line command, in the following manner: 


>string Causes the spacifiad PF key, when used in edit or browse, 
to simulate the entering of a primary command. Example: 


PF1Q ===> >FIND ABC 


Pressing PF10 when browsing or editing data will have 
the same effect as antering a FIND ABC primary command. 


:string Causes the specified PF key, when used in edit, to 
simulate the antering of a line command. Example: 


PF1l ===> :TF 


Prassing PF1l when editing data will have the same 
effect as entering the "TF"™ (text flow) line command on 
oc oever line the cursor is positioned when the key is 
pressed. 


PROGRAM FUNCTION KEY DEFINITION 
ENTER/VERIFY PARAMETERS BELOW FOR 3278 TERMINAL WITH 24 PF KEYS: 


PF1 
PF2 
PF3 
PF4 
PF5 
PF6 
PF7 
PFS 
PF9 
PF10 
PF1l 
PF12 


HELP_ PF13 
SPLIT PF14 
END PF15 
RETURN PF16 
FIND PF17 
CHANGE PF18 
UP PF19 
DOWN PF20 
SWAP PF2i 
LEFT PF22 
RIGHT PF23 
CURSOR PF24 


HELP 
SPLIT 
END 
RETURN 
FINO 
CHANGE 
UP 
DOWN 
SWAP 
LEFT 
RIGHT 
CURSOR 


nreadantkatneed ua 
antennae ad 0 ee 
vvvvvVVvV VV Vv Vv 
eauwnanweteaeeng 
| Se | | | | ee, | | 


vvuvvvVV VV Vv Vv Vv 


VALID OPTIONS: (BLANK RESETS TO DEFAULT OPTION) 
HELP SPLIT ENO RETURN FIND CHANGE 
UP DOWN SWAP LEFT RIGHT CURSOR 
NOP PRINT PRINT-HI 

OR EQUATE TO EDIT/BROWSE COMMAND: 
>CMD... (PRIMARY COMMAND ) EXAMPLE: PF1O == 
3CMD... (EDIT LINE COMMAND} EXAMPLE: PFIl == 


> >TABS ON 
> si 


Figure 21. PF Key Assignment Panel (For 24~-key Terminals) 
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The browse option allows the user to display source data and 
listings stored in SPF libraries or other partitioned or sequen- 
tial data sets with the following characteristics: 


Record Format CRECFM): 
e Fixed, variable (non-spanned), or undefined 


° Blocked or unble-ked 
e With or without printer control characters 


Logical Record Length (LRECL): Up to 32,767 
When browse is selected, an antry panel is displayed to allow the 
user to specify an SPF library or other data set, volume serial 
Cif the data set is not cataloged) and data set password Cif the 
data set is protected). See Figure 22. 
For SPF libraries and other partitioned data sets, the user can 
supply the name of the member to be browsed, or leave the member 
name blank to request a member list from which a member may be 
selected. 
The browse data display is shown in Figure 23. Two lines are 
reserved at the top of the screen for title information, short 
messages, command entry, and the scroll amount. The remainder of 
the screen contains the data. 
During browse, four-way scrolling is available via the Scroll PF 
keys. The FIND and LOCATE commands may also be used to scroll to a 
particular character string, line number, or symbolic label. 


Browse provides the following commands, which may be entered in 
the command input field on line 2: 


LOCATE Scroll to the specified line number or label. 

-xxxxx Establish a label (xxxxx) for the LOCATE command. 

COLS Display a column identification lina. 

RESET Remove column identification line. 

FIND Find a specified character string. 

CAPS Set CAPS mode on or off Caffects FIND command strings). 
HEX Display data in hexadecimal format. 
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BROWSE - ENTRY PANEL 
ENTER/VERIFY PARAMETERS BELOW: 


SPF LIBRARY: 
PROJECT 
LIBRARY 
TYPE 
MEMBER 


(BLANK FOR MEMBER SELECTION LIST) 
OTHER PARTITIONED OR SEQUENTIAL DATASET: 

DATASET NAME 

VOLUME SERIAL (IF NOT CATALOGED) 


DATASET PASSWORD (IF PASSWORD PROTECTED) 


Figure 22. Browse ~- Entry Panel 


BROWSE - SPFDEMO.XXX.COBOLICBLMAIN) - 01.01 LINE 00000 COLS 001 080 
COMMAND INPUT ===> SCROLL ===> PAGE 


{SUHBEBRHOBERBRHEBUBUEBEBHBEHEHBHEE TOP OF DATA siHHHHHHHHEHEHEHEHEHEHECAPS ON-t 


000100 
000200 
000300 
000400 
000500 
000600 
000700 
000800 
000900 
001000 
001100 
001200 
001300 
001400 
001500 
001600 
001700 
001800 
001900 
002000 
002100 
002200 
002300 
002400 
002500 


IDENTIFICATION DIVISION. 
PROGRAM-ID. 'F20D1000'. 
DATE-COMPILED. AUG. 20, 1979 
ENVIRONMENT DIVISION. 
CONFIGURATION SECTION. 
SOURCE-COMPUTER. IBM-370. 
OBJECT-COMPUTER. IBN-370. 
INPUT-OUTPUT SECTION. 
FILE-CONTROL. 
SELECT OLD-COMREC ASSIGN TO DA-S-DD1. 
SELECT DI-REPORTS ASSIGN TO UR-S-DI1OUT. 
SELECT OPTION-CARD-FILE ASSIGN TO UR-S-SYSIN. 
DATA DIVISION. 
FILE SECTION. 
FD OLD-COMREC 
LABEL RECORD IS STANDARD 
RECORDING MODE IS F 
BLOCK CONTAINS 0 RECORDS 
DATA RECORD IS COMRECI. 
COMRECI. 
02 DUMMY PICTURE X(520). 
D1-REPORTS 
LABEL RECORD IS OMITTED 
RECORDING MODE IS F 
BLOCK CONTAINS 133 CHARACTERS 


Figure 23. Browse - Data Display 
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OPTIO ) 


The edit option allows the user to create, display, and modify 
source data (program code, test data, documentation, etc.) stored 
in SPF libraries or other partitioned or sequential data sets with 
the following characteristics: 


Record Format CRECFM): 


e Fixed or variable (non-spanned) 
° Blocked or unblocked 
e With or without printer control characters 


Logical Record Length C(LRECL): 


® From 10 to 255, inclusive, for fixed length records 
e From 14 to 259, inclusive, for variable length records 


The edit entry panel is shown in Figure 24. For edit, a concat~ 
enated sequence of SPF libraries may be specified. The concat- 
enation applies to the fetching of members to be edited. The 
libraries are searched in the designated order to find the member 
and bring it into working storage. When the edited member is 
saved, it is placed Cor replaced) in the first library in the con- 
catenation sequence regardless of which library it came from. 


The panel also allows specification of a profile name, which may 
be entered to override the default edit profile. See description 
under "Edit Modes and Profiles." 


Space for the selected data set must have been previously allo- 
cated, but it may be empty. Selection of an empty sequential data 
set or a nonexistent member of a partitioned data set allows cre- 
ation of new source data. 


The selected member or sequential data set is read into virtual 
storage, wherein it is updated during edit operations. Use of 
virtual storage for edit work space results in high performance, 
but may require a large user region. 


The edit data display is similar to a browse display except that 
each line consists of a 6-column line-number field followed by a 
72-column data field (see Figure 25). The line-number field 
reflects the contents of the sequence numbers in the data, if the 
data is numbered. For unnumbered data, the line numbers start at 
1 and are incremented by 1. 
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- EDIT - ENTRY PANEL 
ENTER/VERIFY PARAMETERS BELOW: 


SPF LIBRARY: 
PROJECT 
LIBRARY 
TYPE 
MEMBER 


=ss? 


(BLANK FOR MEMBER SELECTION LIST) 
OTHER PARTITIONED OR SEQUENTIAL DATASET: 

DATASET NAME 

VOLUME SERTAL (IF NOT CATALOGED ) 
DATASET PASSWORD (IF PASSWORD PROTECTED) 


PROFILE NAME (BLANK DEFAULTS TO DATASET TYPE) 


Figure 24%. Edit - Entry Panel 


EDIT --- SPFDEMO.MYLIB.PLI(COINS) - 01.04 COLUMNS 001 072 
COMMAND INPUT ===> _ SCROLL ===> HALF 
SEMI IEE 9G IEE ENE IE IEEE IEEE IE TEE HE HEE EET IIE TOP OF DATA 2€3636 363696063666 9CE IEEE IE IEE IEIEIEIE IEE EE EE EE 
000100 COINS: 

000200 PROCEDURE OPTIONS (MAIN)5 

000300 DECLARE 

000400 COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 

000500 HALVES FIXED BINARY (31), 

000600 QUARTERS FIXED BINARY (31), 

000700 DIMES FIXED BINARY (31), 

000800 NICKELS FIXED BINARY (31), 

000900 SYSPRINT FILE STREAM OUTPUT PRINTS 

001000 DO HALVES = 100 TO 0 BY -50;3 

001100 DO QUARTERS = (100 - HALVES) TO 0 BY -253 

001200 DO DIMES = ((100 - HALVES - QUARTERS)/10)%10 TO O BY -103 
001300 NICKELS = 100 - HALVES - QUARTERS - DIMES; 

001400 PUT FILE(SYSPRINT) DATA(COUNT,HALVES, QUARTERS »DIMES »NICKELS)3 
001500 COUNT = COUNT + 13 

001600 END $ 

001700 END; 

001800 END; 

001900 END COINS; 

JIE JHHHHEHGHEHIHETIE HEHEHE BOTTOM OF DATA 3336696369636 36 369696169626 9696 E96 IEEE IEIEIEIEIEIEE 


Figure 25. Edit ~ Data Display ) 
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BASIC EDIT OPERATIONS 


Under edit, four-way scrolling is available via the Scroll PF 
keys. The FIND and LOCATE commands may also be used to scroll toa 
particular character string or line number. 


To modify one or more lines of data, the user simply moves the 
cursor to the desired location and enters the new information by 
overtyping the existing lines. Several lines may be modified 
before pressing the ENTER key. 


Lines may be deleted, inserted, shifted left or right (for inden- 
tation changes), duplicated, or rearranged by overtyping the 
line-number fields with "line commands" consisting of one or more 
characters. Frequently used line commands include: 


I - Insert new line. 

D - Delete line. 

R - Repeat (duplicate) line. 

C - Copy line. 

M - Move line. 

A Cafter) - Specify destination of copy or move. 
B (before) - Specify destination of copy or move. 
C or < - Shift line left. 

> or > - Shift line right. 


Single character line commands operate on individual lines (e.g., 
D to delete a line). Double character line commands operate on 
blocks of lines (Ce.g., DD on two different lines to indicate the 
first and last lines to be deleted). In most cases, a number may 
follow the line command to indicate multiple occurrences (e.g., 
I3 to insert three lines). Several line commands as well as data 
modifications may be typed before pressing the ENTER key. 


For general edit operations, "primary commands” may be entered in 
the command input field on line 2. Frequently used primary com- 
mands include: 

LOCATE Scroll to the specified line number. 


RENUM Renumber all lines. 


UNNUM Unnumber all lines (blank out sequence numbers). 
RESET Reset excluded lines and messages. 

SUBMIT Submit edit data to the job stream. 

SAVE Save the data. 


CANCEL Cancel edit without saving. 

FIND Find a specified character string. 

CHANGE Change a specified character string to another string. 
COPY Copy data from another member or data set. 

MOVE Copy data and then delete the member or data set. 
CREATE Create another member or data set from the edit data. 
REPLACE Replace another member or data set from the edit data. 


Additional edit commands are described briefly in the following 
sections. 
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EDIT MODES AND PROFILES 


SPECIAL 


Edit is capable of operating in the following modes: 


e NUMBER Mode —- controls validation and generation of sequence 
numbers. 


e AUTONUM Mode - controls automatic renumbering when the data 
is saved. 


° STATS Mode -— controls generation of SPF library statistics. 


e PRINT Mode = controls automatic recording of source listings 
in the SPF list file. 


e CAPS Mode - controls translation of alphabetic characters to 
uppercase. 


e NULLS Mode ~ controls replacement of trailing blanks with 
null characters on the display screen. 


® TABS Mode - controls use of "hardware”™ or "logical™ tabs. 
e HEX Mode - controls display of data in hexadecimal format. 


° RECOVERY Mode - controls automatic recording of edit trans- 
actions to facilitate recovery following a system failure. 


Each mode may be turned on or off independently of the other modes 
by means of the following primary commands: NUMBER, AUTONUM, 
STATS, PRINT, CAPS, NULLS, TABS, HEX, and RECOVERY. 


The current settings of the modes, together with the current MASK, 
TABS, and BOUNDS lines, are maintained in an edit profile which 
may be displayed at any time via the PROFILE command. When edit 
is terminated, the current profile is automatically saved. 


Up to 25 different edit profiles are maintained for each user. 
This allows different mode settings and different MASK, TABS, and 
BOUNDS lines to be remembered and used as the initial settings for 
different types of source data. 


Each profile is normally associated with the data "type™ (the SPF 
library type or last qualifier in the data set name). When the 
user edits COBOL data, for example, the default profile contains 
whatever modes were in effect the last time the user finished 
editing COBOL data. Additional profiles may be created and used 
by specifying a profile name on the edit entry panel, or as an 
operand on the PROFILE command. 


FEATURES 


Following is a brief discussion of soma of the special features 
provided by the SPF editor. 


e Column Identification Line - A special line may be displayed 
anywhere in the data area of the screen (via the COLS line 
command) to determine column positions. Format of the line 


where "1" indicates column 10, "2" indicates column 20> atc. 


° Insert Mask ~- Information may be pre-entered on inserted 
lines by defining a mask Cvia the MASK line command). The 
contents of the mask remain in effect until changed by the 
user. Initially, the mask contains all blanks. The mask is 
saved as part of the edit profile. 
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e Excluded Lines - Designated lines of data may be temporarily 
excluded from display (via the X or XX line command) to facil- 
itate visual verification of program control structure. 
Excluded lines may also be used to limit the scope of the FIND 
and CHANGE commands. Excluded lines may be redisplayed via 
the S (show), F (first), and L Clast) line commands. The 
hearts lines are removed from display, but not daleted from 

e data. 


e Tabs - Three types of tabs may be defined (via the TABS line 
command): “software” tabs which control cursor repositioning 
when the ENTER key is pressed, “hardware” tabs which cause 
attribute bytes to be inserted at user-defined positions on 
each line of the screen, or "logical" tabs which cause SPF to 
reposition data based on a user-defined special tab charac— 
ter. The tab definitions remain in effect until changed by 
the user, and are saved as part of the edit profile. 


e Bounds - The column boundaries, which delimit the extent of 
the shift line commands and the FIND and CHANGE primary com- 
mands, may be changed at any time (via the BOUNDS line com- 
mand). Normally, these bounds encompass the "statement body” 
of each data record, excluding the sequence number field. The 
bounds are saved as part of the edit profile. 


e Null Characters - Trailing blanks in each data field may be 
displayed as null characters (via the NULLS primary command) 
to facilitate use of the 3270 INSERT key. Normally, all 
blanks are displayed as blanks. 


e Hexadecimal Display ~- Data may be displayed and updated using 
hexadecimal representation. The format may be "data" (two 
character positions per byte) or "vertical™ (one character 
position, but two lines per byte). The user may change char- 
acters by overtyping the hex representation and by issuing 
CHANGE commands with hex syntax. 


e Document Preparation Support - Document preparation is aided 
by commands which facilitate: the bulk entry of text without 
regard for the end of the line, the insertion of new material 
into existing text, and the "reflowing™ of text. 


e Edit Recovery - Under user option, the SPF editor will auto- 
matically maintain a history of change activity. If there is 
a system failure, the user can recover the edit session up to 
the point of failure. A special panel is displayed when edit 
Dhol al to indicate that automatic recovery is_ in 
effect. 


EDIT TERMINATION 


Normally, edit is terminated by pressing the End PF key, which 
causes the data to be saved if any changes have been made. Tha 
user may save the data without terminating edit via the SAVE com- 
mand. The user may also terminate editing without saving via the 
CANCEL command. 


Note: The Return PF key,» which is logically equivalent to 


repeated use of the End PF key, will also cause the data to be 
saved if any changes have occurred. 
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The utility option provides a variety of utility functions for: 
library, data set, and catalog maintenance; moving and copying 
data; resetting SPF library statistics; initiating hardcopy out- 
put; displaying or printing VTOC entries for a DASD voluma; brows- 
ing and printing held SYSOUT data; and formatting SCRIPT/VS 
documentation. 


The utility selection menu is shown in Figure 26. 


SELECT OPTION ===> _ 
1 LIBRARY LIBRARY UTILITY: 

PRINT INDEX LISTING OR ENTIRE DATASET 
PRINT, RENAME, DELETE, OR BROWSE MEMBERS 
COMPRESS DATASET 

DATASET DATASET UTILITY: 
DISPLAY DATASET INFORMATION 
ALLOCATE, RENAME, OR DELETE ENTIRE DATASET 
CATALOG OR UNCATALOG DATASET 

MOVE/COPY - MOVE OR COPY MEMBERS OR DATASETS 

CATALOG CATALOG MANAGEMENT: 
DISPLAY OR PRINT CATALOG ENTRIES 


INITIALIZE OR DELETE USER CATALOG ALIAS 
RESET RESET STATISTICS FOR MEMBERS OF SPF LIBRARY 
HARDCOPY INITIATE HARDCOPY OUTPUT 
vrToc DISPLAY OR PRINT VTOC ENTRIES FOR A DASD VOLUME 
OUTLIST DISPLAY, DELETE, OR PRINT HELD JOB OUTPUT 
SCRIPT/VS - FORMAT, DISPLAY, AND OPTIONALLY PRINT SCRIPT TEXT 


Figure 26. Utility Selection Menu 


For each of tha utility options, a panel is displayed which allows 

the user to select a function and enter the appropriate library or 

data set information. These panels allow both option selection 

ie pote etrny in a single panel format. An example is shown in 
igure . 
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LIBRARY 


LIBRARY UTILITY 
SELECT OPTION ===> _ 
C - COMPRESS DATASET PRINT MEMBER 
X = PRINT INDEX LISTING RENAME MEMBER 
L - PRINT ENTIRE DATASET DELETE MEMBER 
BLANK - DISPLAY MEMBER LIST BROWSE MEMBER 


SPF LIBRARY: 
PROJECT 
LIBRARY 
TYPE 
MEMBER 
NEWNAME 


(IF OPTION “P", “R's "D's OR “B’ SELECTED) 
(IF OPTION "R” SELECTED) 


OTHER PARTITIONED OR SEQUENTIAL DATASET: 
DATASET NAME 
VOLUME SERIAL (IF NOT CATALOGED ) 


DATASET PASSWORD (IF PASSWORD PROTECTED) 


Figure 27. Library Utility Panel 


UTILITY 


The library utility options are shown in Figure 27. 


This utility is intended primarily for maintenance of SPF 
libraries and other partitioned data sets, but options X (index) 
and L Clist) also apply to sequential data sets. 


Option C Ccompress) is operable only if the installation has 
installed a special procedure to allow the IEBCOPY (which 
requires authorization) to run in the foreground under SPF. 


The three print options (X, L,», and P) cause information to be 

recorded in the SPF list file. An index listing includes general 
information about the data set followed by a member list. For a 

riveree data set, the index listing includes general informa- 
ion only. 


Option B Cbrowse) provides a direct interface to browse. All 
browse commands can be executed. When browse is terminated by 
pressing the End PF key, the user is returned to this utility. 


The default option (selected by leaving the option field blank), — 
allows the user to select members for printing, renaming, delet- 
ings or browsing by entering "P™, "R™, "DD", or "B" in front of one 
or more member names on the member list. For renaming, & new mem 
ber name must also be antered in the field immediately following 
the current member name. 
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DATA SET UTILITY 


The data set utility provides the following options: 


A - Allocate new data set 
R - Rename data set 
D - Delete data set 


C - Catalog data set 
U - Uncatalog data set 
blank - Display data set information 


Any DASD-resident sequential or partitioned data set may be spec” 
ified for option A Callocate). Any DASD-resident, non-VSAM data 
sat may be specified for the other options. 


Option A allows specification of volume serial (may specify a real 
DASD volume or an IBM 3850 virtual volume), data set character- 
istics, and space allocation parameters. Default values are 
pre-entered based on the last allocation or the last "display data 
set information” request (whichever occurred most recently). 


Option D (delete) displays a confirmation panel to tnsure that the 
user did not select this option by mistake. As directed in the 
panel, the user must press either the ENTER key to confirm or the 
End PF key to cancel. 


The default option (blank) causes a display of volume serial, data 
set characteristics, current space allocation, and current space 
utilization for the selected data set. This information may be 
used to precondition the defaults for option A Callocate), so that 
aegeree data set may be used as the model for allocating a new 
ata set. 


MOVE/COPY UTILITY 


50. 


The move/copy utility provides the following options: 


CP - Copy data set or member(s) and print 


MP - Move data set or member(s) and print 
C - Copy without print 
M - Move without print 


The first panel displayed allows the user to select one of the 
options listed above, and specify the “from” library or data set. 
When the ENTER key is pressed, a seacond panel is displayed which 
allows the user to specify the "to" library or data set. The fol- 
lowing options must also be specified on the second panel: 


e Replace like-named members CYES or NO), if the "to" data set 
is partitioned. 


e "To" data set disposition (OLD or MOD), if the "to” data set 
is sequential. 


Both data sets must already exist. The utility will not automat- 
ically allocate space for a new "to" data set. 


If a move option is selected (M or MP) and the "from" data set is 
partitioned, the selected members will be deleted in the "from" 
data set after they have been successfully copied. Move froma 
sequential data set causes the entire "from" data set to be 
deleted after its contents have been successfully copied to the 
"to" data set. If a copy option is selected (C or CP), no 
deletions will occur. 


If a print option is selacted (CP or MP), source listings will be 
recorded in the SPF list file. 
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If a member listing is requested, the user may select members to 
be moved or copied by entering an "S" in front of one or more mem- 
ber names. If the "to" data set is partitioned, the members may 
also be renamed by entering a new member name in the field imme- 
diately following the current name. 


CATALOG MANAGEMENT UTILITY 


The catalog management utility provides the following options: 


I - Initialize user catalog alias 
D - Delete catalog alias 

P - Print catalog entries 

blank - Display catalog entries 


Option I Cinitialize) is valid only if there are no data sets cur- 
rently allocated with the specified project name (Cor other 
high-level data set qualifier). It causes all subsequent catalog 
entries for this project name to be placed in the designated user 
catalog, pointed to by a single entry in the master catalog. 


Option D (delete) causes the alias for the designated project name 
to be deleted from the master catalog. 


Option P (Cprint) causes a catalog listing for the designated 
project name to be recorded in the SPF file. Tha default option 
(blank) causes tha catalog listing to be displayed via direct 
entry to browse. 


RESET SPF STATISTICS UTILITY 


The reset SPF statistics utility provides the following options: 


R - Create/update statistics, conditionally reset sequence 
numbers 

N - Create/update statistics, no reset of sequence numbers 

D ~- Delete SPF statistics 


Option R is used to create statistics in an SPF library or other 
partitioned data set which does not currently have them, or to 
update existing statistics. The data is scanned to determine if 
sequence numbers are present in all records. If so, the data is 
renumbered and the modification flags (the last two digits of each 
sequence number) are set to zeros. If sequence numbers are not 
present, renumbering is not done. 


Option N is also used to create or update statistics; however, the 
data is not renumbered. This option should be used if the data 
already contains SPF statistics and the user wants to update the 
user id and/or version information without ranumbering the data. 


Option D is used to delete SPF statistics. 


If a version number is specified, the statistics are created or 
reset as follows: 


Version number: set to the specified value 
Modification level: set to zero 

Creation date: set to current date 

Date/time last modified: set to current date and time 
Current number of lines: set to the current number of lines 
Initial number lines: set to the current number of lines 


Number of modified lines: set to zero 


If member listing is requested, the user may select members to be 
reset by entering an "S" in front of one or more member names. 
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HARDCOPY UTILITY 


The hardcopy utility is used to initiate printing or punching of 
data which is already in the proper format for output. This util- 
ity provides the following options: 


J - Generate JCL to print or punch data set 
L - Route data set to local printer 


Any DASD-resident data seat may be specified except for the SPF 
list and log files. Since list and log remain open throughout the 
session, they may only be printed upon SPF termination. 


For sequential data sets, the user may specify whether the data 
set is to be kept or deleted after printing. (Partitioned data 
set members are always kept.) 


For option J, a SYSOUT class and job statement parameters must be 
specified. The SYSOUT class may specify a printer or punch. 


For option L, a printer id must be specified. When the user 
enters the desired information and presses the ENTER key, SPF 
invokes the "DSPRINT" TSO command processor to print the data set 
on the specified local printer. 


DSPRINT is an IBM Field Developed Program that must be installed 
to use the "L” option. 


LIST vroc UTILITY 


OUTLIST 


The list volume table of contents (VTOC) utility provides the fol- 
lowing options: 


P - Print VTOC entries 
blank - Display VTOC entries 


Option P (print) causes a VTOC listing for the designated volume 
to be recorded in the SPF file. 


The default option (blank) causes the VTOC listing to be displayed 
at the terminal via direct entry to browse. 


For either the print or display options, the VTOC listing may be 


limited to data sets which begin with a designated high-level 
qualifier (specified via project name on the list VIOC panel). 


UTILITY 
The outlist utility provides access to job output which is ina 
held SYSOUT queue. This utility has the following options: 


L - List job names via the TSO STATUS command 
D - Delete job output 


P -=- Print job output 
R - Requeue job output to a new output class 
blank - Display job output 


Option L displays a list of job names and job id's for currently 
held jobs. If no job name is supplied, or if the job name is the 
user's id plus one character, status is displayed for all jobs 
which begin with the user's id. If any other job name is sup~ 
plied, status for that exact job is displayed. , 


Option D deletes the held output for a spacific job from the spec” 
ified SYSOUT queue. 
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Option P removes the held output for a specific job from the 
SYSOUT queue for printing. After the ENTER key is pressed, a pan- 
el is displayed on which the user enters information about how and 
where the job output is to be printed. 


Option R requeues the held output for a specific job to another 
SYSOUT class. 


The default option Cblank) displays held output for the specified 
job via direct entry to browse. The data remains in the SYSOUT 
queue. When the user presses the End PF key to terminate browse, 
the outlist utility panel is redisplayed and the user may then 
choose to print, requeue, or delete the job output. 


SCRIPT/VS UTILITY 


The SCRIPT/VS utility displays a sequence of panels to allow for- 
matting, displaying, and printing of text maintained in SPF 
libraries or other partitioned or sequential data sets. Use of 
this utility requires installation of the Document Composition 
Facility CSCRIPT/VS), Program Product 5748-XX9, with the Fore- 
ground Environment Feature. 


This utility has the following options: 


1 - Draft document options 
2 - Final document options 


For the draft document options, it is assumed that the primary 
interest of the user is to assure that the content, syntax, and 
spelling within the document are correct. The final document 
options provide additional flexibility and control for the user 
interested in specific document formats. 


The draft document options allow the user to specify: 


Spelling Check CYes or No) Other SCRIPT Parms 
Uppercase Only (Yes or No) SCRIPT Profile 
Line Numbering (Yes or No) SCRIPT Macro Library 


The final document options allow the user to specify: 


Spelling Check (Yes or No) 3800 Type Fonts 
Uppercase Only (Yes or No) Binding (Margins) 
Device Type Other SCRIPT Parms 
Lines Per Inch SCRIPT Profile 

Form Width SCRIPT Macro Library 


Form Length 


The first two panels displayed by this utility allow the user to 
select one of the options and enter the appropriate processing 
parameters. The SCRIPT/VS formatter is then invoked. When it 

eg a atl the formatted document is displayed via direct entry 
o browse. 


When the user terminates browse by pressing the End PF key, a 
print panel is displayed to allow the formatted output to be 
printed, kept, or deleted. 
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The foreground option provides an interface to standard language 
processors for foreground compilation, assembly, link edit, or 
debugging of programs stored in SPF libraries. For foreground 
processing of other partitioned or sequential data sets, the 
appropriate TSO prompter commands may be entered directly via the 
command option (primary option 6). 


The foreground selection menu is shown in Figure 28. 


FOREGROUND SELECTION MENU 
SELECT OPTION ===> _ 


PL/I OPTIMIZING COMPILER 
LINKAGE EDITOR 

COBOL INTERACTIVE DEBUG 
FORTRAN INTERACTIVE DEBUG 
PASCAL/VS COMPILER 


SYSTEM ASSEMBLER 

OS/VS COBOL COMPILER 
FORTRAN IV (G1) COMPILER 
PL/T CHECKOUT COMPILER 


Figure 28. Foreground Selection Menu 


When a language processor has been selected, an entry panel is 
displayed to allow the user to enter the appropriate library and 
member names, library concatenation sequence, and processor 
options. Figure 29 shows an example for Assembler. The project 
name, first library name, type qualifier, member name, and list id 
must be specified. The other paramaters ara optional. 


From the entry panel, the user may press either: 


e The ENTER key, which causes the foreground processor to be 
invoked without entering Session Manager mode, or 


® Any one of the SPF Scroll keys, which causes foreground exe- 
cution under control of the Sassion Manager (Cif the Session 
Manager, Program Product 5740-XE2, is installed). 


If the Session Manager is not invoked, the terminal is operated in 
normal TSO fashion. Any communication with the foreground 
processor is in line-I/0 mode. Upon completion of foreground 
processing, three asterisks (***) are displayed. The user may 
then press ENTER to redisplay the entry panel. 
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Under the Session Manager, the terminal is operated according to 
Session Manager procedures. Upon completion of foreground proc~ 
essing the user is prompted to enter a null line to return to SPF 
control and redisplay the entry panel. 


FOREGROUND ASSEMBLY 
ENTER/VERIFY PARAMETERS BELOW: 


PROJECT 
LIBRARY 
TYPE 
MEMBER 


LIST ID ===> LISTASH_ 


ASSEMBLER OPTIONS: 
===> LIST, TEST, TERM,RENT 


CAUTION: DO NOT SPECIFY OPTIONS LIB, LOAD, OR PRINT. THEY ARE GENERATED 
AUTOMATICALLY BY SPF. 


Figure 29. Foreground —- Assembler Example 


The Assembler entry panel shown in Figure 29 is typical of the 
language processor panels. In the figure, a concatenation 
sequence of three SPF libraries has been specified: 


SPFDEMO .XXX.ASM 
SPFDEMO.A.ASM 
SPFDEMO .MASTER.ASM 


Before the foreground processor is invoked, the concatenated 
sequence of libraries is scanned to find the member to be assem- 
bled or compiled (member TOP in this example). If, in this exam- 
ple, member TOP first appears in data set SPFDEMO.A.ASM, the 
following command would be generated. 


ASM ‘SPFDEMO.A.ASMCTOP)' 
LIBC'SYS1.MACLIB', 
*SPFDEMO.XXX.ASM’, 
*SPFDEMO.A.ASM', 
"SPFDEMO .MASTER.ASM‘) 
LOADC*SPFDEMO .XXX.OBJC TOP)" ) 
PRINTCLISTASM) 
LIST, TEST, TERM,RENT 
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The commands generated for the other language processors are sim- 
ilar to the Assembler example, except that: 


e The macro library "SYS1.MACLIB’® is not included in tha con- 
catenation sequence passed via the LIB parameter. 


e For COBOL, an optional TEST parameter may be generated, as 
follows: 


TEST ¢'project-nama. libi-name.SYM(member-name)"). 


The user may control the generation of this parameter via a 
field on the panel. 


e For FORTRAN, there is no LIB parameter. The concatenation 
sequence is still used to locate the member to be compiled. 


e For the two PL/I compilers and PASCAL, an OBJECT parameter 
Crather than LOAD) is generated to designate the destination 
of the object module. 


e For the PL/I Checkout compiler, the OBJECT parameter is 
optional (controlled by a field on the panel). If the user 
specifies OBJECT, the following PLIC parameter is generated: 


OBJECTC *project-name.libl-name.OBJ(Cmember-name)’ 
"project—-name.libl-name.ITEXT') 


If the user specifies NOOBJECT, neither OBJ nor ITEXT data is 
generated. 


In addition, the foreground option automatically generates the 
following optional parameters: 


For ASM: LIB, LOAD, PRINT 

For COBOL: LIB, LOAD, PRINT, TEST 
For FORT: LOAD, PRINT 

For PLIC: LIB, OBJECT, PRINT 

For PLI: LIB, OBJECT, PRINT 

For LINK: LIB, LOAD, PRINT 


For TESTCOB: LOAD, PRINT, PARM 
For TESTFORT: LIB, PRINT, SOURCE 
For PASCAL: LIB, OBJECT, PRINT 


For the linkage editor, the entry panel allows specification of up 
to two system subroutine libraries. The concatenation sequence 
used to locate the member for input to the linkage editor is: 


project~name.libl-name. type 
Po ceec  nomerhweccnemeyee 
etc. 


where "type™ is whatever the user specifies on the panel (may be 
OBJ or may be some other type containing linkage editor control 
statements). If the type is not OBJ, an "OBJECT” DDNAME is auto- 
matically allocated to facilitate use of the following linkage 
editor control statements. 


INCLUDE OBJECT(Cmember~name) 


The concatenation sequence passed to the linkage editor via the 
LIB parameter has a type qualifier of LOAD and includes’ the 
user-specified system libraries, as follows: 


LIBC*project-name.libl~-name.LOAD', 
*'project-name. lib2-name.LOAD’, 


'syslibi-namet, 
"syslib2-name*) 


This concatenation sequence is used by the linkage editor to 
rasolve "automatic call” raferences. 
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The background option provides an interface to standard language 
processors for background compilation, assembly, or link edit of 
programs stored in SPF libraries. For other background jobs, the 
SUBMIT command may be entered vie the command option (primary 
option 6) or via the SUBMIT command under edit. 


The background selection menu is shown itn Figure 30. It allows the 
user to enter job statement information, as well as select a lan- 
guage processor. 


As with other secondary menus, it is possible to bypass the back- 
ground selection menu by entering two numbers, separated by a dec- 
imal point, on the primary option menu. Note, however, that use 
of this procedure does not allow verification or changes to the 
job statement parameters, nor does it allow the generation of mul- 
tiple compilations and/or link edits within the same job. 


SELECT OPTION ===> _ 
1 - SYSTEM ASSEMBLER 
2 - OS/VS COBOL COMPILER 
3 - FORTRAN IV (61) COMPILER 


PL/I CHECKOUT COMPILER 
PL/I OPTIMIZING COMPILER 
LINKAGE EDITOR 
PASCAL/VS COMPILER 


JOB STATEMENT INFORMATION: (VERIFY BEFORE PROCEEDING) 
//7SILVA7 JOB (U602,B8043),'SILVA RJ'»,CLASS=B; 
ff MSGLEVEL=2, 


NOTIFY=SILVA 


i ee eo 


wwvwVYV 


Figure 30. Background Selection Menu 


The data entry panels for background processing are similar to 
those for foregound, except that the user may enter either a list 
id Cif the output listing is to be stored in a data set) or SYSOUT 
class Cif the listing is to be printed as part of the background 
“hanony If both list id and SYSOUT class are specified, list id is 
used. 
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When the user has filled in the entry panel and pressed the ENTER 
key, the appropriate JCL statements are generated. The back- 
ground selection menu jis then redisplayed (unless that menu was 
bypassed) with a "JCL GENERATED" message displayed in the short 
message area (line 1). If the background selection menu was 
bypassed, the generated JCL is submitted and the usar is returned 
to the primary option menu. 


When tha background menu is redisplayed, the job statement param- 
eters are shown for information only -- thay are no longer inten- 
sified and may not be overtyped, since the JOB statement has 
already been generated. At this point, the user may: 


e Select another processor to cause more JCL (additional job 
steps) to be generated, 


e Enter CANCEL to return to the primary option menu without sub- 
mitting the job, or 


e Press the End Cor Return) PF key to cause the generated JCL to 
be submitted for execution. 
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The command option allows direct antry of a TSO command or command 
procedure (CLIST) under SPF. When this option is selected, a 
blank panel is displayed with the following prompt: 


ENTER TSO COMMAND OR CLIST BELOW: 
s=s> 


The command or CLIST is entered to the right of the arrow, using 
standard TSO syntax. It may be continued on the next two lines, 
if necessary. 


The following commands may not be entered under SPF: 


TEST 
LOGON, LOGOFF 
SPF 


Authorized commands Ce.g., RACF commands) 
CALL to an authorized program 


prece the desired command has been typed, the usa@r may press 
either: 


e The ENTER key, which causes the command to be executed without 
entering Session Manager mode, or 


e Any one of the SPF Scroll keys, which causes the command to be 
executed under control of the Session Manager (if the Session 
Manager, Program Product 5740-XE2, is installed). 


If the Session Manager is not invoked, the terminal is operated in 
normal TSO fashion. <Any communication with the command is in 
line-I/0 mode. Upon completion of the command, three asterisks 
(%*%*%) are displayed. The user may then press ENTER to redisplay 
the command panel. 


Under the Session Manager, the terminal is operated according to 
Session Manager procedures. Upon completion of command process~ 
ing, the user is prompted to enter a null line to return to SPF 
control and redisplay the command panel. 


When the command panel is redisplayed, the command which was just 
executed is pre-entered to the right of the arrow. The user may 
then enter another command, or press the End PF key to return to 
the primary option menu. 
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PP 


COPTION 


The support option provides test aids and conversion utilities 
for the development of applications to be run under the SPF dialog 
manager. The support selection menu is shown in Figure 31. 


SELECT OPTION ===> 


TEST PANEL DISPLAY PANEL AS USER WOULD SEE IT 

TEST FUNCTION INVOKE DIALOG FUNCTION OR SELECTION MENU 

TEST VARTABLES - SET OR DISPLAY VARIABLES FOR TEST FUNCTION 
CONVERT MENUS CONVERT SELECTION/TUTORIAL MENUS TO NEW FORMAT 
CONVERT MSGS CONVERT MESSAGES TO NEW FORMAT 


Figure 31. Support Selection Menu 


The test panel option allows a panel definition to be tested by 
displaying it as the end user would see it. The name of the panel 
and, optionally, a message id and initial cursor location may be 
specified. These are the same parameters which may be speci fied 
(from the dialog function) when invoking the display service. 


The test function option allows a dialog function to be tested 
without having to build "scaffolding”™ code. The name of the func- 
tion and parameters that may be passed correspond exactly to what 
may be specified when the function is invoked from a selection 
menu or from another function. 


The test variables option allows dialog variables to be sat and/or 
displayed. It is intended for use with the test panel and test 
function options. 


The convert menus option provides automated conversion from old 
format SPF selection menus and tutorial pages to new format panel 
definitions. This option allows specification of the "from”™ and 
"to" libraries in a manner similar to the move/copy utility 
Coption 3.3). 


The convert messages option provides automated conversion from 
old format SPF massage definitions to new format message defi- 
nitions. It works the same as the convert menus option. 
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The tutorial option provides immediate online reference and 
instruction on how to use the SPF program development facility. 
It may be invoked from the primary option menu or via the Help PF 
key. The tutorial may be viewed sequentially from beginning to 
end, or it may be viewed randomly by selecting specific topics 
from an alphabetic index or table of contents. 


When the tutorial is invoked from the primary option menu, intro- 
ductory pages are displayed to explain how the tutorial works 
(Figure 32). Following the introduction, a table of contents is 
displayed from which the user may select a topic by entering the 
desired saction number. 


When the tutorial is invoked via the Help PF key, the appropriate 
section of the tutorial is entered based on what the user was 
doing when the Help key was pressed. 


When viewing the tutorial, the user may select topics by number, 
or simply press the ENTER key to view the next topic. On any pan- 
el, the user may also enter the following commands: 


BACK or B —- to back up to the previously viewed page 
SKIP or S - to skip to the next topic 

UP or U - to display a higher level list of topics 
TOP or T ~ to display the table of contents 

INDEX or I - to display the tutorial index. 


During execution of the tutorial, the four scroll PF keys are 
interpreted as follows: 


UP - display higher level list of topics 
DOWN (Cskip) - skip to the next topic 

LEFT Cback) - display previous tutorial page 
RIGHT (next) - display next tutorial page 


The ENTER key also means "next." 


The Help PF key may be pressed at any time to display a one-page 
summary of how to use the tutorial. 


The tutorial function is terminated by pressing the End PF key. 


This causes a return either to the primary option menu or to the 
display from which the user requested help. 
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eeeeeo---- === ~-------------- SPF TUTORIAL ----------------- ------ =-------- --- 


STRUCTURED PROGRAMMING FACILITY 
TUTORIAL 


THIS TUTORIAL PROVIDES ON-LINE INFORMATION ABOUT THE FEATURES AND OPERATION 
OF SPF. YOU MAY VIEW THE TUTORIAL SEQUENTIALLY» OR YOU MAY CHOOSE SELECTED 
TOPICS FROM LISTS THAT ARE DISPLAYED ON MANY OF THE TUTORIAL PAGES. 


THE TABLE OF CONTENTS CONTAINS A LIST OF MAJOR TOPICS. SUBSEQUENT PAGES 
CONTAIN ADDITIONAL LISTS THAT LEAD YOU TO MORE SPECIFIC LEVELS OF DETAIL. 
TOPICS MAY ALSO BE SELECTED FROM THE TUTORIAL INDEX. 


THE NEXT TWO PAGES CONTAIN A DESCRIPTION OF HOW TO USE THIS TUTORIAL. 


PRESS ENTER TO PROCEED TO THE NEXT PAGE, OR 
PRESS UP KEY TO GO DIRECTLY TO THE TABLE OF CONTENTS, OR 
PRESS END KEY TO RETURN TO THE PRIMARY OPTION MENU. 


TUTORIAL -------------------- -- INTRODUCTION 
NEXT SELECTION ===> 


YOU MAY VIEW THE TUTORIAL SEQUENTIALLY BY SIMPLY LEAVING THE "NEXT SELECTION” 
FIELD BLANK AND PRESSING THE ENTER KEY. ALTERNATIVELY, YOU MAY SELECT TOPICS 
FROM LISTS THAT ARE DISPLAYED ON MANY OF THE TUTORIAL PAGES. FOR EXAMPLE» 
ENTER: NEXT SELECTION ===> 3 TO SELECT TOPIC 3. 


YOU MAY ALSO ENTER ONE OF THE FOLLOWING CODES IN THE "NEXT SELECTION” FIELD 
ON ANY TUTORIAL PAGE: 
BACK OR B - TO BACK UP TO THE PREVIOUSLY VIEWED PAGE. 
SKIP S - TO SKIP THE CURRENT TOPIC AND GO ON TO THE NEXT TOPIC. 
U - TO DISPLAY A HIGHER LEVEL LIST OF TOPICS. 
T - TO DISPLAY THE TABLE OF CONTENTS. 
I - TO DISPLAY THE TUTORIAL INDEX. 


(CONTINUED ON NEXT PAGE) 


Figure 32. Tutorial - First Two Pages 
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This chapter identifies system requirements and customer respon- 
sibilities. It also includes a brief description of related docu- 
aa that are planned for availability concurrent with product 
release. 


MENTS 


SPF operates as a TSO command processor under the Time Sharing 
Option of VS2 Release 3.8 (MVS). SPF is written in PL/S and 
translated into Assembler Language. The BPAM and BSAM access 
methods are required by SPF for reading and writing data sets, and 
TSO/TCAM or TSO/VTAM are required for terminal communication. 


One of the following teleprocessing access methods is required: 


TCAM 10 Cavailable with MVS) 


ACF/TCAM Version 2, Release 2 or later 5735-RC3 
VTAM 2 Cavailable with MVS) 
ACF/VTAM Release 2 or later 5735-RC2 


The SPF program development facility provides interfaces to the 
cee IBM processing programs for foreground and background 
execution: 


VS2 Assembler Cavailable with MVS) 


TSO Assembler Prompter (foreground only?) 5734-CP2 
COBOL Compiler and Library 5740-CBl 
TSO COBOL Prompter (foreground only) 5734-CP1 
COBOL Interactive Debug (foreground only) 5734-CB4 
FORTRAN IV Gl Compiler 5734-F02 
TSO FORTRAN Prompter (foreground only) 5734-CP3 
FORTRAN Interactive Debug (foreground only) 5734-F05 
PL/I Checkout Compiler 5734-PL2 
PL/I Optimizing Compiler 5734-PL1 
PASCAL/VS Compiler 5796-PNQ 


Linkage Editor Cavailable with MVS) 
The appropriate processing programs and TSO prompters must be 
installed to use the foreground and background options. 


An interface to SCRIPT/VS is also provided to allow formatting, 
display, and printing of taxt maintained in SPF libraries or other 
data sets. Use of this feature requires installation of the fol- 
lowing IBM program product: 

Document Composition Facility (SCRIPT/VS) 5748-XX9 
with the Foreground Environment Feature 


Internal interfaces are provided to tha following IBM programs. 
These programs are not required to operate SPF. However, if an 
IBM 3284, 3286, 3287, 3288, or 3289 printer is used for SPF out- 
put, the appropriate DSPRINT command processor must be installed 
on the system. 


OS/VS2 MVS 3270 Extended Display Support - 


Session Manager, Release 2 §740-XE2 
TSO/TCAM Command Processor "DSPRINT™ 5798~-AYF 
TSO/VTAM Data Set Print (CDSPRINT) 5798-CPF 
TSO/VS2 Programming Control Facility (¢CPCF) 5798-BBJ 
TSO Programming Control Facility ~ II (PCF2) 5798-CLW 


All the program-numbered products listed above can 


separately under IBM licensing agreements. 


be ordered 


Planning 


MACHINE REQUIREMENTS 


The machine requiremants are the same as those for MVS with the 
Time Sharing Option (TSO). 


Approximately 512K bytes of the pageable link pack area (PLPA) ara 
required for SPF program occupancy. The virtual storage requirea- 
ments for each user's region will vary depending upon the applica~ 
tion being executed, the size of tables and data sets, and the use 
of split screen mode. The minimum region size is 512K bytes, but 
a 2048K byte region is recommended. An even larger region may be 
required under certain circumstances. 


Approximately 20 cylinders of IBM 3330 disk storage (or an equiv- 
alent amount of space for other types of devices) are required for 
A la Panel, message, and skeleton libraries distributed 
wi ‘ 


TERMINAL R MENT 


SPF requires one or more of tha following IBM display stations: 


3275 Models 2 and 12 

3276 Models 2, 3, 4, 12> 13, and 14 

3277 Model 2 (local or remote attachment) 

3278 Models 2, 3, 4, and 5 Clocal or remote attachmant) 

3279 All modals (local or remote attachment), when 
operated in 4~color compatibility mode. 


Each display station must ba equipped with one of the following 
keyboards: 


For 3275 or 3277 Display Stations: 


78 Key Operator Console (feature 4632) 

78 Keay EBCDIC Typewriter (feature 4633} 

78 Key ASCII Typewriter (feature 4635) 

78 Key EBCDIC Typewriter/APL (feature 4638), when operated 
with APL switch off. 


For 3276, 3278, or 3279 Display Stations: 


75 Key EBCDIC Typewriter (feature 4621) 

75 Key ASCII Typewriter (feature 4624) 

87 Key EBCDIC Typewriter (feature 4627) 

87 Keay ASCII Typewriter (feature 4628) 

87 Key EBCDIC Typewriter/APL (feature 4626), when operated 
with APL switch off. 

87 Key EBCDIC Typewriter/Text (feature 4629), when operated 
with TEXT switch off. 


The standard character set (94 graphics plus blank and null) is 
supported on 3276, 3278, and 3279 Display Stations. 


The following are supported, but not required: 


Audible alarm (Feature 1090) 
IBM 3284, 3286, 3287, 3288, and 3289 printers 
3277 dual-case character set (RPQ 8K0366) 


Installation of the audible alarm feature is strongly recommended 
to enhance usability. The alarm is sounded whenever a warning or 
error message is displayed. 


Use of the IBM 3284, 3286, 3287, 3288, and 3289 printers requires 
installation of the appropriate DSPRINT command processor. 
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The installation of SPF requires a properly configured IBM Sys- 
tem/370, appropriate terminals and other required devices, and 
MVS with the Time Sharing Option (TS0). Also, appropriate proc~ 
essing programs and TSO prompters must be installed to use the SPF 
foreground and background options, and the Document Composition 
Facility must be installed to use the SCRIPT/VS utility. 


To install SPF, operations personnal must be knowledgeable in 
OS/VS JCL, TS0, and the System Modification Program (SMP). 
Installation procedures are described in the SPF Installation and 
Customization Guide. 


If SPF is to be used with TSO/TCAM, the standard TSO/TCAM messgage 
handler must be reassembled to incorporate minor modifications. 
These modifications are designed to eliminate interference 
between the full screen I/0 operations used by SPF and the 
line-oriented I/0 operations used by TSO. No other changes are 
required to TSO or TCAM. 


A dialog developer must be familiar with MVS, TSO, and appropriate 
programming languages, and should review the SPF Dialog Develop- 
ment Guide. A user of the SPF Program Development Facility must 
be familiar with MVS and TSO, and should review the SPF Program 
Reference Manual. 


Special SPF training or courses are not required for programming 
personnel familiar with the IBM 3270, the programming and machine 
systems, and the language processors in use. 


V ON OF MEN ME GES 


Installations which have previously extended or custom tailored 
SPF may need to convert old format selection menus, tutorials, and 
messages to the new panel and message formats. Conversion utili- 
ties have been provided for this purpose in the program develop- 
ment. facility (new option 7 on the primary option menu). 


All selection menus (displayed by program SPFUTIL in the previous 
SPF products) must be converted to new format to run under the SPF 
dialog manager. Conversion of tutorial pages is optional, but 
recommended, since support for old format tutorial pages may be 
dropped in the future. No attempt should be made to convert fore- 
ground and background entry panels; these are supported in old 
format only. 
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RELATED DOCUMENTS 


66 


The following documents are planned for availability when SPF is 
released. 


° SPF Dialog Development Guidg - Provides detailed information 
on how to develop interactive applications to run under SPF. 
° SPF_ Program Reference Manual - Provides detailed information 


on how to use the SPF program development facility. 


° SPE i Referen Summar Car - Provides a summary of SPF 
program development facility options and command formats. 


® SPF Installation and Customization Guide ~- Provides detailed 
information on how to install and custom tailor SPF. 


° SPF Program Logic Manual - Describes SPF internal logic, 
program structure, and data areas. 


° SPF Program Listings (Microfiche) - Provides compiler and 
assembler listings of SPF programs. 


Two sets of documents will be available: One for SPF with MVS 
Time Sharing Option (SPF-MVS), and the other for SPF with VM/370 
Conversational Monitor System (SPF-VM). 


Two PF key overlays are also planned for availability: One for 
use with IBM 3275 or 3277 terminals, and the other for use with 
IBM 3276, 3278, or 3279 terminals. The overlays are the same for 
SPF-MVS and SPF-VM. 
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H TEM_P VITY TY: A 


Program Name: System Productivity Facility 
Program Number: 5668-009 


The System Productivity Facility is a program development tool 
designed to take advantage of the characteristics of IBM 3270 dis- 
play terminals, and to increase programmer productivity in an 
interactive environment. 


The System Productivity Facility replaces the Structured Program- 

ming Facility program products. It includes’ significant new 

Peoees which simplify the development of interactive applica- 
ions. 


New services are provided to define and control symbolic vari-~ 
ables, display predefined screen images and messages, build and 
maintain permanent tables of user information, generate output 
files for job submission or other processing, interface to edit 
and browse, and log hardcopy output. 


Testing Period: The testing period is one month. 


License: A separate license is required for each 
designated machine on which the licensed pro- 
gram materials will be used, except as other- 
wise provided by IBM. 


Program Services: Central Service and Local Service will be 
available until discontinued by IBM upon six 
month's written notice. Local Service will be 
provided by IBM Field Engineering for DPD and 
IBM Customer Engineering for E/MEZA and A/FE. 


Warranty: The System Productivity Facility is warranted 
to conform to its Licensed Program Specifica- 
tions when shipped to the customer if properly 
used in the specified operating environment. 


Licensed Program Specifications may be updated 
from time to time, and such updates may con- 
stitute a change in specifications. 


Following the discontinuance of all program 
services, this program will be distributed on 
an "As Is" basis without warranty of any kind 
either express or implied. 


Availability: The estimated availability dates at PID 


(Program Information Department) are December 
1980 for SPF-MVS, and April 1981 for SPF-VM. 
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The System Productivity Facility (SPF) supports two environments: 


e MVS Time Sharing Option (SPF-MVS) 
e VM/370 Conversational Monitor System (SPF-VM) 


SPF provides equivalent function in the two environments. Inter~- 
faces to dialog services, display formats, and operation are ful- 
ly compatible except for those features which are explicitly 
oriented to the particular environment. Following is a summary of 
the differences. 


DIALOG MANAGER 


° Under SPF-MVS a dialog function may be a program module or a 
CLIST. Under SPF-VM a dialog function may be a program module 
or an EXEC (coded in EXEC2 language). The CLIST and EXEC2 
qo usuneee are native to the environment, and differ in syn- 

ax. 


° Under SPF-MVS a module function must be link edited; it is 
invoked via LINK. Under SPF-VM a module function is not link 
edited; it is invoked via LOAD, and other modules which it 
references are automatically loaded with it. 


e The edit and browse interface services under SPF-MVS require 
specification of a data set name and, optionally, a voluma 
serial and OS password. Under SPF-VM these services require 
specification of a CMS file id and, optionally, a member name 
(for MACLIBs or TXTLIBs). 


e In SPF-VM, the system variable ZPREFIX Cuser prefix) has the 
same value as ZUSER Cuser id). 


e In SPF-VM, the "CONTROL DISPLAY SM" (Session Manager) service 
has the same meaning as "CONTROL DISPLAY LINE”. 


° Before entering SPF, certain libraries must be set up (pan- 
els, messages, skeletons, and tables). The procedures differ 
in the two environments. For SPF-MVS, concatenated parti- 
tioned data sets must be allocated to specified DDNAMEs. For 
ane concatenated MACLIBs must be specified with FILEDEF 
commands. 
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On the primary option manu, option 6 is: 


SPF-MVS: Enter TSO Command or CLIST 
SPF-VM : Enter CMS Command or EXEC 


Panels and tutorials which refer to "data sets” in SPF-MVS 
refer to "files™ in SPF-VM. The first part of an entry panel 
(browse or edit, for axample) allows specification of an SPF 
library. The format is identical in SPF-MVS and SPF-VM: 


SPF LIBRARY: 
PROJECT 
LIBRARY 


TYPE 
MEMBER 


1 ou 
vvvyv 


(BLANK FOR MEMBER SELECTION LIST) 


The second part of an entry panel differs as follows. For 
SPF-MVS: 


OTHER PARTITIONED SEQUENTIAL DATASET: 
DATASET NAME 
VOLUNE SERIAL (IF NOT CATALOGED) 


For SPF-VM: 


CMS FILE: 
FILE ID 
MEMBER (FOR MACLIB OR TXTLIB) 


DEVICE ADOR. LINK ACCESS MODE ===> 


The third part of an entry panel contains an (05) password 
field for SPF-MVS. For SPF-VM, this part of the panel may 
contain a read password field, an update password field, or 
both, depending on the type of function. In SPF-MVS, pass- 
eral pertain to data sets; in SPF-VM, they pertain to mini-~ 
disks. 


Implementation of SPF libraries is accomplished in SPF-MVS 
using partitioned data sets, while SPF-VM uses sequential CMS 
files and/or MACLIBs and TXTLIBs Cunder user option). 


SPF-MVS supports printing on either: 


System printer (via submission of a background job) 
328x printer (via interface to DSPRINT command) 


SPF-VM supports printing via the CMS PRINT command. The out- 
put may be directed to the system printer or spooled to anoth- 
raha Cor machine), which may be at a remote node in the 
network. 


Specification of "job statement information™ occurs in 
SPF-MVS on the background selection menu and all panels per- 
taining to hardcopy output. SPF-VM provides job information 
on the batch selection menu only. All other output is accom- 
Plished with the CMS PRINT, PUNCH, or DISK DUMP commands, 
rather than via job submission. 


Additionally, job statement information syntax and keywords 
are different, reflecting differences between CMS batch job 
streams and VS2 JCL. 
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Differences in foreground processing Coption 4) and back- 
ground (batch) processing (option 5) are as follows: 


SPF-MVS: Compiled/assembled output Cobject module) goes into 
an SPF library whose "type” is OBJ. Link edit out- 
put Cload module) goes into an SPF library whose 
"type" is LOAD. 


SPF-VM: Compiled/assembled output Cobject module) goes into 
an SPF library whose "type" is TEXT. Linkage edit- 
oe not supported, but the LOAD command is sup- 
ported. 


Option 3.2 Cdataset/file utility). The following suboptions 
of this utility in SPF-MVS: 


A - Allocate new data set 
C - Catalog data set 
U - Uncatalog data set 


are replaced in SPF-VM with: 


S ~ Specify new SPF library 
U - Unspecify SPF library 


There is no need for an "allocate file" capability under 
SPF-VM, since space allocation is handled automatically by 
VM/CMS. There is, however, a need to pre-specify SPF library 
identifiers and file characteristics to SPF-VM. 


Option 3.4. In SPF-MVS this is the catalog management utili- 
ty. In SPF-VM it is replaced with the project utility, which 
provides a similar function for SPF libraries. 


Option 3.6. In SPF-MVS this is the hardcopy utility. In 
SPF-VM it is replaced with the spool utility, which provides 
similar functions for printing and punching, and also allows 
spooling to another user (Cor machine), which may be at a 
remote node in the network. 


Option 3.7. In SPF-MVS this is the list VTOC utility, which 
has no equivalent in SPF-VM. It is replaced in SPF-VM with 
the reader utility. 


Option 3.8. In SPF-MVS this is the outlist utility, which has 


no equivalent in SPF-VM. It is replaced in SPF-VM with the 
retrieve utility. 
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